Http C# Reference Documentation

Http

Current Version: 10.0.0

Requires Chilkat Bundle License

Class for sending HTTP requests and receiving server responses.

Supports GET, POST, HEAD, PUT, DELETE, WebDav, and custom HTTP request methods.
HTTP Authentication: Basic, NTLM, Digest, Negotiate
HTTPS (SSL/TLS) with client-side certificate capabilities.
Cookie caching, auto-resend, persisting to XML files.
Content caching.
Supports HTTP proxies
Auto-follow redirects if desired.
Amazon S3 methods.
XML HTTP Request
HTTP file upload capabilities
Asynchronous features -- putting HTTP requests in background threads.
Supports SOCK5/SOCKS4 proxies.
IPv6 capable.

Object Creation

Chilkat.Http obj = new Chilkat.Http();

Properties

AbortCurrent

public bool AbortCurrent {get; set; }

Introduced in version 9.5.0.58

When set to true, causes the currently running method to abort. Methods that always finish quickly (i.e.have no length file operations or network communications) are not affected. If no method is running, then this property is automatically reset to false when the next method is called. When the abort occurs, this property is reset to false. Both synchronous and asynchronous method calls can be aborted. (A synchronous method call could be aborted by setting this property from a separate thread.)

Accept

public string Accept {get; set; }

The Accept header field to be automatically included with GET requests issued by QuickGet or QuickGetStr. The default value is "*/*".

AcceptCharset

public string AcceptCharset {get; set; }

The Accept-Charset header field to be automatically included with GET requests issued by QuickGet or QuickGetStr. The default value is the empty string, which means no Accept-Charset header is included.

AcceptLanguage

public string AcceptLanguage {get; set; }

The Accept-Language header field to be automatically included with GET requests issued by QuickGet or QuickGetStr. The default value is "en-us,en;q=0.5".

AllowGzip

public bool AllowGzip {get; set; }

Controls whether the "Accept-Encoding: gzip" header is added to HTTP requests sent via any method that sends an HTTP request without using the HttpRequest object (such as QuickGetStr). If false, then the empty Accept-Encoding header is added which means the server response should contain the uncompressed content. The default value is true, which means the server, if it chooses, may send a gzipped response.

AllowHeaderFolding

public bool AllowHeaderFolding {get; set; }

Introduced in version 9.5.0.63

If this property is set to false, then no MIME header folding will be automatically applied to any request header. The default is true.

AuthSignature

public string AuthSignature {get; set; }

Introduced in version 9.5.0.89

If set, then automatically adds the Authorization: Signature keyId="...", algorithm="...", headers="...", signature="..." header to all requests. This property should be set to a JSON string containing the information needed to compute and automatically add the HTTP Signature. See the example(s) below.

More Information and Examples

(.NET Core C#) Refinitiv World-Check One - Get Top Level Groups (C#) Refinitiv World-Check One - Get Top Level Groups (Mono C#) Refinitiv World-Check One - Get Top Level Groups (PowerShell) Refinitiv World-Check One - Get Top Level Groups

AuthToken

public string AuthToken {get; set; }

Introduced in version 9.5.0.67

If set, then automatically adds the "Authorization: Bearer " header to all requests. (If you have an OAuth2 access token, set this property equal to the OAuth2 access token string. Note: For OAuth1 (older) tokens, use the OAuthTOken property. )

More Information and Examples

(.NET Core C#) Using the OAuth2 Authorization Token in REST API Calls (C#) Using the OAuth2 Authorization Token in REST API Calls (Mono C#) Using the OAuth2 Authorization Token in REST API Calls (PowerShell) Using the OAuth2 Authorization Token in REST API Calls

AutoAddHostHeader

public bool AutoAddHostHeader {get; set; }

If set to true, the "Host" header field will automatically be added to the request header for any QuickGet or QuickGetStr method calls. The value of the Host header field is taken from the hostname part of the URL passed to QuickGet/QuickGetStr.

AwsAccessKey

public string AwsAccessKey {get; set; }

The AWS Access Key to be used with the Amazon S3 methods listed below.

AwsEndpoint

public string AwsEndpoint {get; set; }

The regional endpoint (domain) to be used for Amazon S3 method calls. The default value is "s3.amazonaws.com". This can be set to any valid Amazon S3 endpoint, such as "s3-eu-west-1.amazonaws.com", or the endpoints for S3-API compatible services from other different providers.

More Information and Examples

(.NET Core C#) Using an S3 Compatible Storage Provider (C#) Using an S3 Compatible Storage Provider (Mono C#) Using an S3 Compatible Storage Provider (PowerShell) Using an S3 Compatible Storage Provider

AwsRegion

public string AwsRegion {get; set; }

Introduced in version 9.5.0.56

The AWS (S3) region, such as "us-east-1", "us-west-2", "eu-west-1", "eu-central-1", etc. This propery defaults to "us-east-1". It is only used when the AwsSignatureVersion property is set to 4. When the AwsSignatureVersion property is set to 2, then this property is unused.

AwsSecretKey

public string AwsSecretKey {get; set; }

The AWS Secret Key to be used with the Amazon S3 methods listed below.

AwsSessionToken

public string AwsSessionToken {get; set; }

Introduced in version 9.5.0.95

This is only used if a set of temporary security credentials were obtained by calling the AssumeRole action of the AWS Security Token Service.

AwsSignatureVersion

public int AwsSignatureVersion {get; set; }

Introduced in version 9.5.0.56

Selects the AWS Signature Version algorithm. The default value is 4. May be set to 2 to select AWS Signature Version 2. (The only valid choices are 2 and 4.)

AwsSubResources

public string AwsSubResources {get; set; }

The AWS sub-resources to be used with the Amazon S3 methods listed below.

If the S3 request needs to address a sub-resource, like ?versioning, ?policy, ?location, ?acl, or ?torrent, or ?versionid append the sub-resource and its value if it has one. Note that in case of multiple sub-resources, sub-resources must be lexicographically sorted by sub-resource name and separated by '&'. e.g. "acl&versionId=value"

The list of sub-resources that can be included are: acl, location, logging, notification, partNumber, policy, requestPayment, torrent, uploadId, uploads, versionId, versioning, versions and website.

BandwidthThrottleDown

public int BandwidthThrottleDown {get; set; }

Introduced in version 9.5.0.49

If non-zero, limits (throttles) the download bandwidth to approximately this maximum number of bytes per second. The default value of this property is 0.

BandwidthThrottleUp

public int BandwidthThrottleUp {get; set; }

Introduced in version 9.5.0.49

If non-zero, limits (throttles) the upload bandwidth to approximately this maximum number of bytes per second. The default value of this property is 0.

BasicAuth

public bool BasicAuth {get; set; }

If HTTP basic authentication is needed, this property must be set to true. The HTTP protocol allows for several different types of authentication schemes, such as NTLM, Digest, OAuth1, etc. A given server will support (or allow) certain authentication schemes (also known as authentication methods). Except for the "Basic" authentication method, the other forms of authentication do not involve sending the login and password in plain unencrypted text over the connection. The Basic authentication method is insecure in that it sends the login/password for all to see. If the connection is SSL/TLS, then this might be considered OK. Chilkat takes the safe approach and will not allow Basic authentication unless this property has been explicitly set to true. The default value of this property is false.

Note: It is not required to know the authentication methods accepted by the server beforehand (except for the case of Basic authentication). When authentication is required, Chilkat will first send the request without the Authorization header, receive back the 401 Authorization Required response along with information about what authentication methods are accepted, and then re-send with an accepted authentication method. If the authentication method is known in advance, then an application may set the appropriate property, such as NtlmAuth to true so that the extra (internal) round-trip is not required.

Note: The login and password is sent using the utf-8 byte representation. Some servers expect the ANSI byte representation (typically Windows-1252). Starting in Chilkat v9.5.0.87, to send the login/password using ANSI, add the "AnsiLogin" keyword to the UncommonOptions property.

More Information and Examples

(.NET Core C#) HTTP Basic Authentication Test (C#) HTTP Basic Authentication Test (Mono C#) HTTP Basic Authentication Test (PowerShell) HTTP Basic Authentication Test

ClientIpAddress

public string ClientIpAddress {get; set; }

The IP address to use for computers with multiple network interfaces or IP addresses. For computers with a single network interface (i.e. most computers), this property should not be set. For multihoming computers, the default IP address is automatically used if this property is not set.

The IP address is a string such as in dotted notation using numbers, not domain names, such as "165.164.55.124".

More Information and Examples

Important Bind to Adapter Notes for Windows

ConnectFailReason

public int ConnectFailReason {get; }

Introduced in version 9.5.0.56

This property will be set to the status of the last HTTP connection made (or failed to be made) by any HTTP method.

Possible values are:

0 = success

Normal (non-TLS) sockets:
1 = empty hostname
2 = DNS lookup failed
3 = DNS timeout
4 = Aborted by application.
5 = Internal failure.
6 = Connect Timed Out
7 = Connect Rejected (or failed for some other reason)
50 = HTTP proxy authentication failure.
98 = Async operation in progress.
99 = Product is not unlocked.

SSL/TLS:
100 = TLS internal error.
101 = Failed to send client hello.
102 = Unexpected handshake message.
103 = Failed to read server hello.
104 = No server certificate.
105 = Unexpected TLS protocol version.
106 = Server certificate verify failed (the server certificate is expired or the cert's signature verification failed).
107 = Unacceptable TLS protocol version.
108 = App-defined server certificate requirements failure.
109 = Failed to read handshake messages.
110 = Failed to send client certificate handshake message.
111 = Failed to send client key exchange handshake message.
112 = Client certificate's private key not accessible.
113 = Failed to send client cert verify handshake message.
114 = Failed to send change cipher spec handshake message.
115 = Failed to send finished handshake message.
116 = Server's Finished message is invalid.
125 = Peer tried to connect using older SSL 2.0 protocol version.
126 = TLS Pin Set Mismatch.
127 = TLS 1.3 handshake error.

Connection

public string Connection {get; set; }

The Connection header field to be automatically included with GET requests issued by QuickGet or QuickGetStr. The default value is "Keep-Alive". To prevent the Connection header from being added to the HTTP header, set this property to the empty string.

ConnectTimeout

public int ConnectTimeout {get; set; }

The amount of time in seconds to wait before timing out when connecting to an HTTP server. The default ConnectTimeout is 30 seconds.

Note: This is the maximum number of seconds to wait for a server to accept a TCP connection. Once the connection is accepted, and bytes begin flowing back-and-forth, then it is the ReadTimeout property that applies. It is the ReadTimeout that applies when receiving data, which includes the reads that occur during a TLS handshake.

CookieDir

public string CookieDir {get; set; }

Specifies a directory where cookies are automatically persisted if the Http.SaveCookies property is turned on. Cookies are stored in XML formatted files, one per domain, to main it easy for other programs to understand and parse. May be set to the string "memory" to cache cookies in memory.

More Information and Examples

(.NET Core C#) Caching cookies in-memory.(C#) Caching cookies in-memory.(Mono C#) Caching cookies in-memory.(PowerShell) Caching cookies in-memory.

DebugLogFilePath

public string DebugLogFilePath {get; set; }

If set to a file path, causes each Chilkat method or property call to automatically append it's LastErrorText to the specified log file. The information is appended such that if a hang or crash occurs, it is possible to see the context in which the problem occurred, as well as a history of all Chilkat calls up to the point of the problem. The VerboseLogging property can be set to provide more detailed information.

This property is typically used for debugging the rare cases where a Chilkat method call hangs or generates an exception that halts program execution (i.e. crashes). A hang or crash should generally never happen. The typical causes of a hang are:

a timeout related property was set to 0 to explicitly indicate that an infinite timeout is desired,
the hang is actually a hang within an event callback (i.e. it is a hang within the application code), or
there is an internal problem (bug) in the Chilkat code that causes the hang.

More Information and Examples

(.NET Core C#) Example showing how to use DebugLogFilePath.(C#) Example showing how to use DebugLogFilePath.(Mono C#) Example showing how to use DebugLogFilePath.(PowerShell) Example showing how to use DebugLogFilePath.

DefaultFreshPeriod

public int DefaultFreshPeriod {get; set; }

The default freshness period (in minutes) for cached documents when the FreshnessAlgorithm property is set to 0. The default value is 10080 (1 week).

DigestAuth

public bool DigestAuth {get; set; }

Setting this property to true causes the HTTP component to use digest authentication. The default value is false.

More Information and Examples

(.NET Core C#) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(C#) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(Mono C#) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(PowerShell) HTTP Authentication (Basic, NTLM, Digest, Negotiate)

FetchFromCache

public bool FetchFromCache {get; set; }

Set to true if pages should be fetched from cache when possible. Only HTTP GET requests are cached. HTTP responses that include Set-Cookie headers are not cached. A page is fetched from the disk cache if it is present and it is "fresh" according to the FreshnessAlgorithm property. If a page exists in cache but is not fresh, the HTTP component will issue a revalidate request and update the cache appropriately according to the response.

More Information and Examples

(.NET Core C#) Fetch Web Pages from Local Cache (C#) Fetch Web Pages from Local Cache (Mono C#) Fetch Web Pages from Local Cache (PowerShell) Fetch Web Pages from Local Cache

FinalRedirectUrl

public string FinalRedirectUrl {get; }

If an HTTP GET was redirected (as indicated by the WasRedirected property), this property will contain the final redirect URL, assuming the FollowRedirects property is true.

Note: Starting in v9.5.0.49, this property will contain the redirect URL for 301/302 responses even if FollowRedirects is not set to true.

FollowRedirects

public bool FollowRedirects {get; set; }

If true, then 301, 302, 303, 307, and 308 redirects are automatically followed when calling QuickGet and QuickGetStr. FollowRedirects is true by default.

FreshnessAlgorithm

public int FreshnessAlgorithm {get; set; }

The freshness algorithm to use when determining the freshness of a cached HTTP GET response. A value of 1 causes an LM-factor algorithm to be used. This is the default. The LMFactor property is a value between 1 and 100 indicating the percentage of time based on the last-modified date of the HTML page. For example, if the LMFactor is 50, and an HTML page was modified 10 days ago, then the page will expire (i.e. no longer be fresh) in 5 days (50% of 10 days). This only applies to HTTP responses that do not have page expiration information. If the FreshnessAlgorithm = 0, then a constant expire time period determined by the DefaultFreshPeriod property is used.

HeartbeatMs

public int HeartbeatMs {get; set; }

This property is only valid in programming environment and languages that allow for event callbacks.

Specifies the time interval in milliseconds between AbortCheck events. A value of 0 (the default) indicate that no AbortCheck events will fire. Any HTTP operation can be aborted via the AbortCheck event.

More Information and Examples

HeartbeatMs and the AbortCheck Event

IgnoreMustRevalidate

public bool IgnoreMustRevalidate {get; set; }

Some HTTP responses contain a "Cache-Control: must-revalidate" header. If this is present, the server is requesting that the client always issue a revalidate HTTP request instead of serving the page directly from cache. If IgnoreMustRevalidate is set to true, then Chilkat HTTP will serve the page directly from cache without revalidating until the page is no longer fresh.

The default value of this property is false.

IgnoreNoCache

public bool IgnoreNoCache {get; set; }

Some HTTP responses contain headers of various types that indicate that the page should not be cached. Chilkat HTTP will adhere to this unless this property is set to true.

The default value of this property is false.

KeepResponseBody

public bool KeepResponseBody {get; set; }

Introduced in version 9.5.0.55

If true, then the response body, if text, is saved to the LastResponseBody property for all methods that do not return an HttpResponse object. The default value of this property is false.

More Information and Examples

(.NET Core C#) S3 Delete Bucket (C#) S3 Delete Bucket (Mono C#) S3 Delete Bucket (PowerShell) S3 Delete Bucket

LastContentType

public string LastContentType {get; }

The content-type of the last HTTP response received by the HTTP component.

LastErrorHtml

public string LastErrorHtml {get; }

Provides information in HTML format about the last method/property called. If a method call returns a value indicating failure, or behaves unexpectedly, examine this property to get more information.

LastErrorText

public string LastErrorText {get; }

Provides information in plain-text format about the last method/property called. If a method call returns a value indicating failure, or behaves unexpectedly, examine this property to get more information.

More Information and Examples

Concept of LastErrorText LastErrorText Standard Information

LastErrorXml

public string LastErrorXml {get; }

Provides information in XML format about the last method/property called. If a method call returns a value indicating failure, or behaves unexpectedly, examine this property to get more information.

LastFromCache

public bool LastFromCache {get; }

Introduced in version 9.5.0.91

true if the last GET was fetched from cache.

More Information and Examples

(.NET Core C#) Fetch Web Pages from Local Cache (C#) Fetch Web Pages from Local Cache (Mono C#) Fetch Web Pages from Local Cache (PowerShell) Fetch Web Pages from Local Cache

LastHeader

public string LastHeader {get; }

The text of the last HTTP header sent by any of this class's methods. The purpose of this property is to allow the developer to examine the exact HTTP header for debugging purposes.

LastMethodSuccess

public bool LastMethodSuccess {get; set; }

Indicate whether the last method call succeeded or failed. A value of true indicates success, a value of false indicates failure. This property is automatically set for method calls. It is not modified by property accesses. The property is automatically set to indicate success for the following types of method calls:

Any method that returns a string.
Any method returning a Chilkat object, binary bytes, or a date/time.
Any method returning a standard boolean status value where success = true and failure = false.
Any method returning an integer where failure is defined by a return value less than zero.

Note: Methods that do not fit the above requirements will always set this property equal to true. For example, a method that returns no value (such as a "void" in C++) will technically always succeed.

LastModDate

public string LastModDate {get; }

The value of the Last-Modified header in the last HTTP response received by the HTTP component.

LastResponseBody

public string LastResponseBody {get; }

Introduced in version 9.5.0.55

The response body of the last HTTP response received by the HTTP component (for methods that do not return an HttpResponse object). The last response body is only saved to this property IF the KeepResponseBody property is set to true.

LastResponseHeader

public string LastResponseHeader {get; }

The entire response header for the last HTTP response received by the HTTP component (for methods that do not return an HttpResponse object).

More Information and Examples

(.NET Core C#) Get Response Header for Method that does not Return HttpResponse Object (C#) Get Response Header for Method that does not Return HttpResponse Object (Mono C#) Get Response Header for Method that does not Return HttpResponse Object (PowerShell) Get Response Header for Method that does not Return HttpResponse Object

LastStatus

public int LastStatus {get; }

The last HTTP status value received by the HTTP component. This only applies to methods that do not return an HTTP response object. For methods that return an HTTP response object, such as SynchronousRequest, the status code is found in the StatusCode property of the response object.

LastStatusText

public string LastStatusText {get; }

Introduced in version 9.5.0.69

The last HTTP status text received by the HTTP component. This only applies to methods that do not return an HTTP response object. For methods that return an HTTP response object, such as SynchronousRequest, the status text is found in the StatusText property of the response object.

LMFactor

public int LMFactor {get; set; }

An integer between 1 and 100 that indicates the percentage of time from the HTTP page's last-modified date that will be used for the freshness period. The default value is 25. For example, if a page is fetched with a last-modified date of 4 weeks ago, and the LMFactor = 25, then the page will be considered fresh in the cache for 1 week (25% of 4 weeks).

Login

public string Login {get; set; }

The HTTP login for pages requiring a login/password. Chilkat HTTP can do Basic, Digest, and NTLM HTTP authentication. (NTLM is also known as SPA (or Windows Integrated Authentication). To use Basic authentication, the BasicAuth property must be set equal to true. It is not necessary to set the NtlmAuth or DigestAuth properties beforehand if NTLM or Digest authentication is needed. However, it is most efficient to pre-set these properties when the type of authentication is known in advance.

Important: If NTLM authentication is used, it may be incorrect to set the Login property equal to "mydomain\mylogin". Instead, set the LoginDomain property equal to "mydomain", and set this property equal to "mylogin".

Note: When the Login and Password properties are set, and the type of authentication is specified by setting one of the following properties equal to true (BasicAuth, DigestAuth, NtlmAuth), Chilkat will automatically add the "Authorization: ..." header in the correct format.

More Information and Examples

(.NET Core C#) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(C#) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(Mono C#) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(PowerShell) HTTP Authentication (Basic, NTLM, Digest, Negotiate)

LoginDomain

public string LoginDomain {get; set; }

The optional domain name to be used with NTLM / Negotiate authentication.

MaxConnections

public int MaxConnections {get; set; }

The maximum number of simultaneous open HTTP connections managed by the HTTP component. The Chilkat HTTP component automatically manages HTTP connections. If the number of open HTTP connections is about to be exceeded, the connection with the least recent activity is automatically closed.

MaxFreshPeriod

public int MaxFreshPeriod {get; set; }

Limits the amount of time a document can be kept "fresh" in the cache. The MaxFreshPeriod is specified in minutes, and the default value is 525600 which is equal to 1 year.

MaxResponseSize

public uint MaxResponseSize {get; set; }

The maximum HTTP response size to be accepted by the calling program. A value of 0 (the default) indicates that there is no maximum value.

MaxUrlLen

public int MaxUrlLen {get; set; }

The Http class will automatically fail any URL longer than this length. The default MaxUrlLen is 2000 characters.

MimicFireFox

public bool MimicFireFox {get; set; }

If set to true, then the appropriate headers to mimic Mozilla/FireFox are automatically added to requests sent via the QuickGet and QuickGetStr methods.

MimicIE

public bool MimicIE {get; set; }

If set to true, then the appropriate headers to mimic Internet Explorer are automatically added to requests sent via the QuickGet and QuickGetStr methods.

MinFreshPeriod

public int MinFreshPeriod {get; set; }

The freshness period for a document in cache will not be less than this value (in minutes). The default value is 30.

NegotiateAuth

public bool NegotiateAuth {get; set; }

Set this property equal to true for Negotiate authentication.

Note: The NegotiateAuth property is only available for the Microsoft Windows operating system.

More Information and Examples

(.NET Core C#) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(C#) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(Mono C#) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(PowerShell) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(.NET Core C#) HTTPS Windows Integrated Authentication (C#) HTTPS Windows Integrated Authentication (Mono C#) HTTPS Windows Integrated Authentication (PowerShell) HTTPS Windows Integrated Authentication

NtlmAuth

public bool NtlmAuth {get; set; }

Setting this property to true causes the HTTP component to use NTLM authentication (also known as IWA -- or Integrated Windows Authentication) when authentication with an HTTP server. The default value is false.

More Information and Examples

(.NET Core C#) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(C#) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(Mono C#) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(PowerShell) HTTP Authentication (Basic, NTLM, Digest, Negotiate)(.NET Core C#) HTTPS Windows Integrated Authentication (C#) HTTPS Windows Integrated Authentication (Mono C#) HTTPS Windows Integrated Authentication (PowerShell) HTTPS Windows Integrated Authentication

NumCacheLevels

public int NumCacheLevels {get; set; }

The number of directory levels to be used under each cache root. The default is 0, meaning that each cached HTML page is stored in a cache root directory. A value of 1 causes each cached page to be stored in one of 255 subdirectories named "0","1", "2", ..."255" under a cache root. A value of 2 causes two levels of subdirectories ("0..255/0..255") under each cache root. The HTTP control automatically creates subdirectories as needed. The reason for mutliple levels is to alleviate problems that may arise with unrelated software when huge numbers of files are stored in a single directory. For example, Windows Explorer does not behave well when trying to display the contents of directories with thousands of files.

More Information and Examples

(.NET Core C#) Fetch Web Pages from Local Cache (C#) Fetch Web Pages from Local Cache (Mono C#) Fetch Web Pages from Local Cache (PowerShell) Fetch Web Pages from Local Cache

NumCacheRoots

public int NumCacheRoots {get; }

The number of cache roots to be used for the HTTP cache. This allows the disk cache spread out over multiple disk drives. Each cache root is a string indicating the drive letter and directory path. For example, "E:\Cache". An example of a very large low-cost cache might be four USB external drives. To create a cache with four roots, call AddCacheRoot once for each directory root.

OAuth1

public bool OAuth1 {get; set; }

If true then causes an OAuth Authorization header to be added to any request sent by the HTTP object. For example:

Authorization: OAuth realm="http://sp.example.com/",
                oauth_consumer_key="0685bd9184jfhq22",
                oauth_token="ad180jjd733klru7",
                oauth_signature_method="HMAC-SHA1",
                oauth_signature="wOJIO9A2W5mFwDgiDvZbTSMK%2FPY%3D",
                oauth_timestamp="137131200",
                oauth_nonce="4572616e48616d6d65724c61686176",
                oauth_version="1.0"

The information used to compute the OAuth Authorization header is obtained from the other OAuth* properties, such as OAuthConsumerKey, OAuthConsumerSecret, OAuthRealm, etc.

More Information and Examples

(.NET Core C#) Mastercard ICCP Get Data Source with OAuth1 (C#) Mastercard ICCP Get Data Source with OAuth1 (Mono C#) Mastercard ICCP Get Data Source with OAuth1 (PowerShell) Mastercard ICCP Get Data Source with OAuth1 (.NET Core C#) BrickLink OAuth1 using Chilkat HTTP (C#) BrickLink OAuth1 using Chilkat HTTP (Mono C#) BrickLink OAuth1 using Chilkat HTTP (PowerShell) BrickLink OAuth1 using Chilkat HTTP

OAuthBodyHash

public bool OAuthBodyHash {get; set; }

Introduced in version 9.5.0.91

If set to true, then the oauth_body_hash is automatically added to an OAuth1 Authorization header. The oauth_body_hash contains the SHA-256 hash of the HTTP request body that is sent.

OAuthCallback

public string OAuthCallback {get; set; }

Introduced in version 9.5.0.53

The OAuth 1.0 callback URL. Defaults to "oob".

OAuthConsumerKey

public string OAuthConsumerKey {get; set; }

The OAuth consumer key to be used in the Authorization header.

OAuthConsumerSecret

public string OAuthConsumerSecret {get; set; }

The OAuth consumer secret to be used in computing the contents of the Authorization header.

OAuthRealm

public string OAuthRealm {get; set; }

The OAuth realm to be used in the Authorization header.

OAuthSigMethod

public string OAuthSigMethod {get; set; }

The OAuth signature method, such as "HMAC-SHA1" to be used in the Authorization header. The default is "HMAC-SHA1". It is also possible to choose "HMAC-SHA256", "RSA-SHA1" or "RSA-SHA2". For RSA algorithms, an RSA private key would need to be provided via the SetOAuthRsaKey method.

Note: RSA-SHA2 is supported starting in Chilkat v9.5.0.56

OAuthToken

public string OAuthToken {get; set; }

The OAuth1 token to be used in the Authorization header. Note: This is for OAuth1. Use the AuthToken property for OAuth2.

More Information and Examples

(.NET Core C#) Twitter OAuth -- Tweet to Your Own Account (C#) Twitter OAuth -- Tweet to Your Own Account (Mono C#) Twitter OAuth -- Tweet to Your Own Account (PowerShell) Twitter OAuth -- Tweet to Your Own Account

OAuthTokenSecret

public string OAuthTokenSecret {get; set; }

The OAuth token secret to be used in computing the Authorization header.

OAuthVerifier

public string OAuthVerifier {get; set; }

The OAuth verifier to be used in the Authorization header.

Password

public string Password {get; set; }

The HTTP password for pages requiring a login/password. Chilkat HTTP can do Basic, Digest, and NTLM HTTP authentication. (NTLM is also known as SPA (or Windows Integrated Authentication). To use Basic authentication, the BasicAuth property must be set equal to true. It is not necessary to set the NtlmAuth or DigestAuth properties beforehand if NTLM or Digest authentication is needed. However, it is most efficient to pre-set these properties when the type of authentication is known in advance.

Note: When the Login and Password properties are set, and the type of authentication is specified by setting one of the following properties equal to true (BasicAuth, DigestAuth, NtlmAuth), Chilkat will automatically add the "Authorization: ..." header in the correct format.

PercentDoneScale

public int PercentDoneScale {get; set; }

Introduced in version 9.5.0.49

This property is only valid in programming environment and languages that allow for event callbacks.

Sets the value to be defined as 100% complete for the purpose of PercentDone event callbacks. The defaut value of 100 means that at most 100 event PercentDone callbacks will occur in a method that (1) is event enabled and (2) is such that it is possible to measure progress as a percentage completed. This property may be set to larger numbers to get more fine-grained PercentDone callbacks. For example, setting this property equal to 1000 will provide callbacks with .1 percent granularity. For example, a value of 453 would indicate 45.3% competed. This property is clamped to a minimum value of 10, and a maximum value of 100000.

PreferIpv6

public bool PreferIpv6 {get; set; }

If true, then use IPv6 over IPv4 when both are supported for a particular domain. The default value of this property is false, which will choose IPv4 over IPv6.

ProxyAuthMethod

public string ProxyAuthMethod {get; set; }

Set this to "basic" if you know in advance that Basic authentication is to be used for the HTTP proxy. Otherwise leave this property unset. Note: It is not necessary to set this property. The HTTP component will automatically handle proxy authentication for any of the supported authentication methods: NTLM, Digest, or Basic. Setting this property equal to "basic" prevents the 407 response which is automatically handled internal to Chilkat and never seen by your application.

Note: If NTLM authentication does not succeed, set the Global.DefaultNtlmVersion property equal to 1 and then retry.

ProxyDirectTls

public bool ProxyDirectTls {get; set; }

Introduced in version 9.5.0.83

Set to true if the proxy server expects a direct TLS connection. (This is where the initial connection to the HTTP proxy server is TLS. See Squid Direct TLS Connection. The default value of this property is false.

More Information and Examples

(.NET Core C#) HTTPS Requests over Squid Proxy Direct TLS Connection (C#) HTTPS Requests over Squid Proxy Direct TLS Connection (Mono C#) HTTPS Requests over Squid Proxy Direct TLS Connection (PowerShell) HTTPS Requests over Squid Proxy Direct TLS Connection

ProxyDomain

public string ProxyDomain {get; set; }

The domain name of a proxy host if an HTTP proxy is used. This can also be set to an IP address.

More Information and Examples

(.NET Core C#) Using an HTTP Proxy for HTTP POST's, GET's, etc.(C#) Using an HTTP Proxy for HTTP POST's, GET's, etc.(Mono C#) Using an HTTP Proxy for HTTP POST's, GET's, etc.(PowerShell) Using an HTTP Proxy for HTTP POST's, GET's, etc.

ProxyLogin

public string ProxyLogin {get; set; }

If an HTTP proxy is used and it requires authentication, this property specifies the HTTP proxy login.

ProxyLoginDomain

public string ProxyLoginDomain {get; set; }

The NTLM authentication domain (optional) if NTLM authentication is used.

ProxyPassword

public string ProxyPassword {get; set; }

If an HTTP proxy is used and it requires authentication, this property specifies the HTTP proxy password.

More Information and Examples

(.NET Core C#) Using an HTTP Proxy for HTTP POST's, GET's, etc.(C#) Using an HTTP Proxy for HTTP POST's, GET's, etc.(Mono C#) Using an HTTP Proxy for HTTP POST's, GET's, etc.(PowerShell) Using an HTTP Proxy for HTTP POST's, GET's, etc.

ProxyPort

public int ProxyPort {get; set; }

The port number of a proxy server if an HTTP proxy is used.

ReadTimeout

public int ReadTimeout {get; set; }

The amount of time in seconds to wait before timing out when reading from an HTTP server. The ReadTimeout is the amount of time that needs to elapse while no additional data is forthcoming. During a long download, if the data stream halts for more than this amount, it will timeout. Otherwise, there is no limit on the length of time for the entire download.

The default value is 60 seconds. Note: Prior to v9.5.0.76, the default was 20 seconds.

ReceivedCertReq

public bool ReceivedCertReq {get; }

Introduced in version 9.5.0.92

Indicates whether the last HTTPS connection received a TLS CertificateRequest handshake message indicating that the server may require a client certificate.

RedirectVerb

public string RedirectVerb {get; set; }

Indicates the HTTP verb, such as GET, POST, PUT, etc. to be used for a redirect when the FollowRedirects property is set to true. The default value of this property is "GET". This will produce the same behavior as a web browser (such as FireFox). If this property is set to the empty string, then it will cause the same verb as the original HTTP request to be used.

Note: Prior to version 9.5.0.44, the default value of this property was the empty string.

Referer

public string Referer {get; set; }

The Referer header field to be automatically included with GET requests issued by QuickGet or QuickGetStr. The default value is the empty string which causes the Referer field to be omitted from the request header.

RequiredContentType

public string RequiredContentType {get; set; }

If set, then any HTTP response to any POST or GET, including downloads, will be rejected if the content-type in the response header does not match this setting. If the content-type does not match, only the header of the HTTP response is read, the connection to the HTTP server is closed, and the remainder of the response is never read.

This property is empty (zero-length string) by default.

Some typical content-types are "text/html", "text/xml", "image/gif", "image/jpeg", "application/zip", "application/msword", "application/pdf", etc.

RequireSslCertVerify

public bool RequireSslCertVerify {get; set; }

If true, then the HTTP client will verify the server's SSL certificate. The certificate is expired, or if the cert's signature is invalid, the connection is not allowed. The default value of this property is false.

More Information and Examples

(.NET Core C#) Require that the Web Server's SSL Certificate is Non-Expired and the Signature is Valid (C#) Require that the Web Server's SSL Certificate is Non-Expired and the Signature is Valid (Mono C#) Require that the Web Server's SSL Certificate is Non-Expired and the Signature is Valid (PowerShell) Require that the Web Server's SSL Certificate is Non-Expired and the Signature is Valid

S3Ssl

public bool S3Ssl {get; set; }

If true, then all S3_* methods will use a secure SSL/TLS connection for communications. The default value is true.

SaveCookies

public bool SaveCookies {get; set; }

If this property is true, cookies are automatically persisted to XML files in the directory specified by the CookiesDir property (or in memory if CookieDir = "memory"). Both CookiesDir and SaveCookies must be set for cookies to be persisted.

More Information and Examples

(.NET Core C#) Caching cookies in-memory.(C#) Caching cookies in-memory.(Mono C#) Caching cookies in-memory.(PowerShell) Caching cookies in-memory.

SendBufferSize

public int SendBufferSize {get; set; }

The buffer size to be used with the underlying TCP/IP socket for sending. The default value is 65535.

SendCookies

public bool SendCookies {get; set; }

If true, then cookies previously persisted to the CookiesDir are automatically added to all HTTP requests. Only cookies matching the domain and path are added.

More Information and Examples

(.NET Core C#) Caching cookies in-memory.(C#) Caching cookies in-memory.(Mono C#) Caching cookies in-memory.(PowerShell) Caching cookies in-memory.

SessionLogFilename

public string SessionLogFilename {get; set; }

Enables file-based session logging. If set to a filename (or relative/absolute filepath), then the exact HTTP requests and responses are logged to a file. The file is created if it does not already exist, otherwise it is appended.

More Information and Examples

(.NET Core C#) Debugging HTTP (C#) Debugging HTTP (Mono C#) Debugging HTTP (PowerShell) Debugging HTTP (.NET Core C#) HTTP Session Logging (C#) HTTP Session Logging (Mono C#) HTTP Session Logging (PowerShell) HTTP Session Logging

SniHostname

public string SniHostname {get; set; }

Introduced in version 9.5.0.82

Specifies the SNI hostname to be used in the TLS ClientHello. This property is only needed when the domain is specified via a dotted IP address and an SNI hostname is desired. (Normally, Chilkat automatically uses the domain name in the SNI hostname TLS ClientHello extension.)

SocksHostname

public string SocksHostname {get; set; }

The SOCKS4/SOCKS5 hostname or IPv4 address (in dotted decimal notation). This property is only used if the SocksVersion property is set to 4 or 5).

More Information and Examples

(.NET Core C#) HTTP/HTTPS using SOCKS5 Proxy (C#) HTTP/HTTPS using SOCKS5 Proxy (Mono C#) HTTP/HTTPS using SOCKS5 Proxy (PowerShell) HTTP/HTTPS using SOCKS5 Proxy (.NET Core C#) HTTP/HTTPS using SOCKS4 Proxy (C#) HTTP/HTTPS using SOCKS4 Proxy (Mono C#) HTTP/HTTPS using SOCKS4 Proxy (PowerShell) HTTP/HTTPS using SOCKS4 Proxy

SocksPassword

public string SocksPassword {get; set; }

The SOCKS5 password (if required). The SOCKS4 protocol does not include the use of a password, so this does not apply to SOCKS4.

SocksPort

public int SocksPort {get; set; }

The SOCKS4/SOCKS5 proxy port. The default value is 1080. This property only applies if a SOCKS proxy is used (if the SocksVersion property is set to 4 or 5).

SocksUsername

public string SocksUsername {get; set; }

The SOCKS4/SOCKS5 proxy username. This property is only used if the SocksVersion property is set to 4 or 5).

More Information and Examples

(.NET Core C#) HTTP/HTTPS using SOCKS5 Proxy (C#) HTTP/HTTPS using SOCKS5 Proxy (Mono C#) HTTP/HTTPS using SOCKS5 Proxy (PowerShell) HTTP/HTTPS using SOCKS5 Proxy (.NET Core C#) HTTP/HTTPS using SOCKS4 Proxy (C#) HTTP/HTTPS using SOCKS4 Proxy (Mono C#) HTTP/HTTPS using SOCKS4 Proxy (PowerShell) HTTP/HTTPS using SOCKS4 Proxy

SocksVersion

public int SocksVersion {get; set; }

SocksVersion May be set to one of the following integer values:

0 - No SOCKS proxy is used. This is the default.
4 - Connect via a SOCKS4 proxy.
5 - Connect via a SOCKS5 proxy.

More Information and Examples

(.NET Core C#) HTTP/HTTPS using SOCKS5 Proxy (C#) HTTP/HTTPS using SOCKS5 Proxy (Mono C#) HTTP/HTTPS using SOCKS5 Proxy (PowerShell) HTTP/HTTPS using SOCKS5 Proxy (.NET Core C#) HTTP/HTTPS using SOCKS4 Proxy (C#) HTTP/HTTPS using SOCKS4 Proxy (Mono C#) HTTP/HTTPS using SOCKS4 Proxy (PowerShell) HTTP/HTTPS using SOCKS4 Proxy

SoRcvBuf

public int SoRcvBuf {get; set; }

Sets the receive buffer size socket option. Normally, this property should be left unchanged. The default value is 4194304.

This property can be increased if download performance seems slow. It is recommended to be a multiple of 4096.

More Information and Examples

More Information about TCP performance and Buffer Sizes

SoSndBuf

public int SoSndBuf {get; set; }

Sets the send buffer size socket option. Normally, this property should be left unchanged. The default value is 262144.

This property can be increased if upload performance seems slow. It is recommended to be a multiple of 4096. Testing with sizes such as 512K and 1MB is reasonable.

More Information and Examples

More Information about TCP performance and Buffer Sizes

SslAllowedCiphers

public string SslAllowedCiphers {get; set; }

Introduced in version 9.5.0.48

Provides a means for setting a list of ciphers that are allowed for SSL/TLS connections. The default (empty string) indicates that all implemented ciphers are possible. The TLS ciphers supported in Chilkat v9.5.0.55 and later are:

TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_256_CBC_SHA256
TLS_RSA_WITH_AES_256_GCM_SHA384
TLS_RSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_RSA_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA
TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA
TLS_RSA_WITH_3DES_EDE_CBC_SHA
TLS_ECDHE_RSA_WITH_RC4_128_SHA
TLS_RSA_WITH_RC4_128_SHA
TLS_RSA_WITH_RC4_128_MD5
TLS_DHE_RSA_WITH_DES_CBC_SHA
TLS_RSA_WITH_DES_CBC_SHA

To restrict SSL/TLS connections to one or more specific ciphers, set this property to a comma-separated list of ciphers such as "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384, TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384". The order should be in terms of preference, with the preferred algorithms listed first. (Note that the client cannot specifically choose the algorithm is picked because it is the server that chooses. The client simply provides the server with a list from which to choose.)

The property can also disallow connections with servers having certificates with RSA keys less than a certain size. By default, server certificates having RSA keys of 512 bits or greater are allowed. Add the keyword "rsa1024" to disallow connections with servers having keys smaller than 1024 bits. Add the keyword "rsa2048" to disallow connections with servers having keys smaller than 2048 bits.

Note: Prior to Chilkat v9.5.0.55, it was not possible to explicitly list allowed cipher suites. The deprecated means for indicating allowed ciphers was both incomplete and unprecise. For example, the following keywords could be listed to allow matching ciphers: "aes256-cbc", "aes128-cbc", "3des-cbc", and "rc4". These keywords will still be recognized, but programs should be updated to explicitly list the allowed ciphers.

secure-renegotiation: Starting in Chilkat v9.5.0.55, the keyword "secure-renegotiation" may be added to require that all renegotions be done securely (as per RFC 5746).

best-practices: Starting in Chilkat v9.5.0.55, this property may be set to the single keyword "best-practices". This will allow ciphers based on the current best practices. As new versions of Chilkat are released, the best practices may change. Changes will be noted here. The current best practices are:

If the server uses an RSA key, it must be 1024 bits or greater.
All renegotations must be secure renegotiations.
All ciphers using RC4, DES, or 3DES are disallowed.

Example: The following string would restrict to 2 specific cipher suites, require RSA keys to be 1024 bits or greater, and require secure renegotiations: "TLS_DHE_RSA_WITH_AES_256_CBC_SHA256, TLS_RSA_WITH_AES_256_CBC_SHA, rsa1024, secure-renegotiation"

SslProtocol

public string SslProtocol {get; set; }

Introduced in version 9.5.0.46

Selects the SSL/TLS protocol version to be used for connections. Possible values are:

default
TLS 1.3
TLS 1.2
TLS 1.1
TLS 1.0
SSL 3.0
TLS 1.3 or higher
TLS 1.2 or higher
TLS 1.1 or higher
TLS 1.0 or higher

The default value is "default" which allows for the protocol to be selected dynamically at runtime based on the requirements of the server. Choosing an exact protocol will cause the connection to fail unless that exact protocol is negotiated. It is better to choose "X or higher" than an exact protocol. The "default" is effectively "SSL 3.0 or higher".

StreamResponseBodyPath

public string StreamResponseBodyPath {get; set; }

Introduced in version 9.5.0.49

Allows for the HTTP response body to be streamed directly into a file. If this property is set, then any method returning an HTTP response object will stream the response body directly to the file path specified. The HTTP response object will still contain the response header. (This property is useful when the HTTP response is too large to fit into memory.)

TlsCipherSuite

public string TlsCipherSuite {get; }

Introduced in version 9.5.0.49

Contains the current or last negotiated TLS cipher suite. If no TLS connection has yet to be established, or if a connection as attempted and failed, then this will be empty. A sample cipher suite string looks like this: TLS_DHE_RSA_WITH_AES_256_CBC_SHA256.

TlsPinSet

public string TlsPinSet {get; set; }

Introduced in version 9.5.0.55

Specifies a set of pins for Public Key Pinning for TLS connections. This property lists the expected SPKI fingerprints for the server certificates. If the server's certificate (sent during the TLS handshake) does not match any of the SPKI fingerprints, then the TLS handshake is aborted and the connection fails. The format of this string property is as follows:

hash_algorithm, encoding, SPKI_fingerprint_1, SPKI_fingerprint_2, ...

For example, the following string specifies a single sha256 base64-encoded SPKI fingerprint:

"sha256, base64, lKg1SIqyhPSK19tlPbjl8s02yChsVTDklQpkMCHvsTE="

This example specifies two SPKI fingerprints:

"sha256, base64, 4t37LpnGmrMEAG8HEz9yIrnvJV2euVRwCLb9EH5WZyI=, 68b0G5iqMvWVWvUCjMuhLEyekM5729PadtnU5tdXZKs="

Any of the following hash algorithms are allowed:.sha1, sha256, sha384, sha512, md2, md5, haval, ripemd128, ripemd160,ripemd256, or ripemd320.

The following encodings are allowed: base64, hex, and any of the encodings indicated in the link below.

More Information and Examples

Encodings Supported by Chilkat (.NET Core C#) HTTP Public Key Pinning (C#) HTTP Public Key Pinning (Mono C#) HTTP Public Key Pinning (PowerShell) HTTP Public Key Pinning

TlsVersion

public string TlsVersion {get; }

Introduced in version 9.5.0.49

Contains the current or last negotiated TLS protocol version. If no TLS connection has yet to be established, or if a connection as attempted and failed, then this will be empty. Possible values are "SSL 3.0", "TLS 1.0", "TLS 1.1", "TLS 1.2", and "TLS 1.3".

UncommonOptions

public string UncommonOptions {get; set; }

This is a catch-all property to be used for uncommon needs. This property defaults to the empty string and should typically remain empty. Can be set to a list of the following comma separated keywords:

"QuickDisconnect" - Introduced in v9.5.0.77. In the call to CloseAllConnections, do not disconnect cleanly. Instead just disconnect as quickly as possible.
"ProtectFromVpn" - Introduced in v9.5.0.80. On Android systems, will bypass any VPN that may be installed or active.
"TlsNoClientRootCert" - Introduced in v9.5.0.82. Will exclude root CA certs from being included in the client certificate chain that is sent to the server for client-side authentication. This must be set prior to calling SetSslClientCert.
"AllowEmptyHeaders" - Introduced in v9.5.0.82. If present, an empty value string passed to SetHeaderField will cause the header to be added with an empty value. Otherwise, for historical purposes and backward compatibility, the header field is removed when an empty value string is passed.
"AnsiLogin" - Introduced in v9.5.0.87. For HTTP basic authentication, the login and password is sent using the utf-8 byte representation. Some servers expect the ANSI byte representation (typically Windows-1252). Use this keyword to send the login/password using ANSI.

UpdateCache

public bool UpdateCache {get; set; }

Controls whether the cache is automatically updated with the responses from HTTP GET requests.

More Information and Examples

(.NET Core C#) Fetch Web Pages from Local Cache (C#) Fetch Web Pages from Local Cache (Mono C#) Fetch Web Pages from Local Cache (PowerShell) Fetch Web Pages from Local Cache

UseIEProxy

public bool UseIEProxy {get; set; }

If true, the proxy address/port used by Internet Explorer will also be used by Chilkat HTTP. Note: This property only pays attention to the proxy address and port, and does not pay attention to additional information such as IE proxy server exceptions.

UserAgent

public string UserAgent {get; set; }

This property, if set, is the value of the User-Agent header field to be automatically included with GET requests issued by QuickGet or QuickGetStr. The default value is the empty string and no User-Agent header field will be sent.

VerboseLogging

public bool VerboseLogging {get; set; }

If set to true, then the contents of LastErrorText (or LastErrorXml, or LastErrorHtml) may contain more verbose information. The default value is false. Verbose logging should only be used for debugging. The potentially large quantity of logged information may adversely affect peformance.

Version

public string Version {get; }

Version of the component/library, such as "9.5.0.94"

More Information and Examples

(.NET Core C#) How to get the Chilkat version at runtime.(C#) How to get the Chilkat version at runtime.(Mono C#) How to get the Chilkat version at runtime.(PowerShell) How to get the Chilkat version at runtime.

WasRedirected

public bool WasRedirected {get; }

Indicates whether the last HTTP request was redirected (i.e. the redirect was automatically followed). If FollowRedirects is false and the response status code is 301, 302, 303, 307, or 308, then this property will remain false but the FinalRedirectUrl will contain the redirect URL that was not automatically followed.

Methods

AddCacheRoot

public void AddCacheRoot(string dir);

This method must be called at least once if disk caching is to be used. The file path (including drive letter) such as "E:\MyHttpCache\" is passed to AddCacheRoot to specify the root directory. The cache can be spread across multiple disk drives by calling AddCacheRoot multiple times, each with a directory path on a separate disk drive.

More Information and Examples

(.NET Core C#) Fetch Web Pages from Local Cache (C#) Fetch Web Pages from Local Cache (Mono C#) Fetch Web Pages from Local Cache (PowerShell) Fetch Web Pages from Local Cache

ClearHeaders

public void ClearHeaders();

Introduced in version 9.5.0.77

Removes all headers added via the SetRequestHeader method.

ClearInMemoryCookies

public void ClearInMemoryCookies();

Clears all cookies cached in memory. Calling this only makes sense if the CookieDir property is set to the string "memory".

ClearUrlVars

public void ClearUrlVars();

Introduced in version 9.5.0.67

Clears all URL variable values previously set by one or more calls to SetUrlVar.

CloseAllConnections

public bool CloseAllConnections();

Closes all connections still open from previous HTTP requests.

An HTTP object instance will maintain up to 10 connections. If the HTTP server's response does not include a "Connection: Close" header, the connection will remain open and will be re-used if possible for the next HTTP request to the same hostname:port. (It uses the IP address (in string form) or the domain name, whichever is used in the URL provided by the application.) If 10 connections are already open and another is needed, the object will close the least recently used connection.

Returns true for success, false for failure.

CloseAllConnectionsAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task CloseAllConnectionsAsync();

Creates an asynchronous task to call the CloseAllConnections method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

CreateOcspRequest

public bool CreateOcspRequest(JsonObject requestDetails, BinData ocspRequest);

Introduced in version 9.5.0.75

Creates an OCSP request for one or more certificates. The requestDetails is a JSON document describing the content of the OCSP request to be created. The examples in the links below show how to build the JSON request details.

Note: This method only creates an OCSP request. After creating, it may be sent to a server to get the OCSP response.

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) Validate Certificate using OCSP Protocol (C#) Validate Certificate using OCSP Protocol (Mono C#) Validate Certificate using OCSP Protocol (PowerShell) Validate Certificate using OCSP Protocol

CreateTimestampRequest

public bool CreateTimestampRequest(string hashAlg, string hashVal, string reqPolicyOid, bool addNonce, bool reqTsaCert, BinData timestampToken);

Introduced in version 9.5.0.75

Creates an RFC 3161 time-stamp request and returns the binary request token in timestampToken. The hashAlg can be "sha1", "sha256", "sha384", "sha512", or "md5", The hashVal is the base64 hash of the data to be timestamped. The optional reqPolicyOid is the requested policy OID in a format such as "1.3.6.1.4.1.47272.1.2". The addNonce indicates whether to auto-generate and include a nonce in the request. It may be true or false. The reqTsaCert determines whether or not to request the TSA's certificate (true = Yes, false = No).

Note: This method only creates a timestamp request. After creating, it may be sent to a server to get the binary timestamp token.

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) RFC3161 Timestamp Client - Fetch from Timestamp Authority (TSA) and Verify (C#) RFC3161 Timestamp Client - Fetch from Timestamp Authority (TSA) and Verify (Mono C#) RFC3161 Timestamp Client - Fetch from Timestamp Authority (TSA) and Verify (PowerShell) RFC3161 Timestamp Client - Fetch from Timestamp Authority (TSA) and Verify (.NET Core C#) Combine Timestamp Reply and Content File into a TimeStampData (C#) Combine Timestamp Reply and Content File into a TimeStampData (Mono C#) Combine Timestamp Reply and Content File into a TimeStampData (PowerShell) Combine Timestamp Reply and Content File into a TimeStampData

DnsCacheClear

public void DnsCacheClear();

Introduced in version 9.5.0.38

Clears the Chilkat-wide in-memory hostname-to-IP address DNS cache. Chilkat automatically maintains this in-memory cache to prevent redundant DNS lookups. If the TTL on the DNS A records being accessed are short and/or these DNS records change frequently, then this method can be called clear the internal cache. Note: The DNS cache is used/shared among all Chilkat objects in a program, and clearing the cache affects all Chilkat objects.

Download

public bool Download(string url, string localFilePath);

Retrieves the content at a URL and saves to a file. All content is saved in streaming mode such that the memory footprint is small and steady. HTTPS is fully supported, as it is with all the methods of this class.

Returns true for success, false for failure.

More Information and Examples

HTTP Downloads Explained (.NET Core C#) HTTP Download any Type of File (binary or text)(C#) HTTP Download any Type of File (binary or text)(Mono C#) HTTP Download any Type of File (binary or text)(PowerShell) HTTP Download any Type of File (binary or text)(.NET Core C#) Debugging HTTP (C#) Debugging HTTP (Mono C#) Debugging HTTP (PowerShell) Debugging HTTP (.NET Core C#) HTTP Download in Parallel with Simultaneous Range Requests (C#) HTTP Download in Parallel with Simultaneous Range Requests (Mono C#) HTTP Download in Parallel with Simultaneous Range Requests (PowerShell) HTTP Download in Parallel with Simultaneous Range Requests

DownloadAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task DownloadAsync(string url, string localFilePath);

Creates an asynchronous task to call the Download method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

DownloadAppend

public bool DownloadAppend(string url, string filename);

Same as the Download method, but the output file is open for append.

Returns true for success, false for failure.

More Information and Examples

HTTP Downloads Explained

DownloadAppendAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task DownloadAppendAsync(string url, string filename);

Creates an asynchronous task to call the DownloadAppend method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

DownloadBd

public bool DownloadBd(string url, BinData binData);

Introduced in version 9.5.0.63

Downloads the content at the url into a BinData object.

Returns true for success, false for failure.

More Information and Examples

HTTP Downloads Explained (.NET Core C#) Upload In-Memory Binary Data to Google Cloud Storage (C#) Upload In-Memory Binary Data to Google Cloud Storage (Mono C#) Upload In-Memory Binary Data to Google Cloud Storage (PowerShell) Upload In-Memory Binary Data to Google Cloud Storage (.NET Core C#) Box.com Download Binary File to Memory (C#) Box.com Download Binary File to Memory (Mono C#) Box.com Download Binary File to Memory (PowerShell) Box.com Download Binary File to Memory (.NET Core C#) Download Image (JPG, GIF, etc.) to Base64 (C#) Download Image (JPG, GIF, etc.) to Base64 (Mono C#) Download Image (JPG, GIF, etc.) to Base64 (PowerShell) Download Image (JPG, GIF, etc.) to Base64

DownloadBdAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task DownloadBdAsync(string url, BinData binData);

Introduced in version 9.5.0.63

Creates an asynchronous task to call the DownloadBd method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

DownloadHash

public string DownloadHash(string url, string hashAlgorithm, string encoding);

Retrieves the content at a URL and computes and returns a hash of the content. The hash is returned as an encoded string according to the encoding, which may be "Base64", "modBase64", "Base32", "UU", "QP" (for quoted-printable), "URL" (for url-encoding), "Hex", "Q", "B", "url_oath", "url_rfc1738", "url_rfc2396", and "url_rfc3986". The hashAlgorithm may be "sha1", "sha256", "sha384", "sha512", "md2", "md5", "haval", "ripemd128", "ripemd160","ripemd256", or "ripemd320".

Returns null on failure

More Information and Examples

HTTP Downloads Explained

DownloadHashAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task DownloadHashAsync(string url, string hashAlgorithm, string encoding);

Creates an asynchronous task to call the DownloadHash method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

DownloadSb

public bool DownloadSb(string url, string charset, StringBuilder sb);

Introduced in version 9.5.0.63

Downloads the content at the url into a Chilkat StringBuilder object. The charset tells Chilkat how to interpret the bytes received. The sb is appended with the downloaded text data.

Returns true for success, false for failure.

More Information and Examples

HTTP Downloads Explained

DownloadSbAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task DownloadSbAsync(string url, string charset, StringBuilder sb);

Introduced in version 9.5.0.63

Creates an asynchronous task to call the DownloadSb method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

ExtractMetaRefreshUrl

public string ExtractMetaRefreshUrl(string htmlContent);

Convenience method for extracting the META refresh URL from HTML. For example, if the htmlContent contains a META refresh tag, such as:

<meta http-equiv="refresh" content="5;URL='http://example.com/'">

Then the return value of this method would be "http://example.com/".

Returns null on failure

G_SvcOauthAccessToken

public string G_SvcOauthAccessToken(string iss, string scope, string subEmail, int numSec, Cert cert);

Introduced in version 9.5.0.44

Makes an access token request to obtain a Google API OAuth2 access token for a service account. Access tokens issued by the Google OAuth 2.0 Authorization Server expire one hour after they are issued. When an access token expires, then the application should generate another JWT, sign it, and request another access token. The iss is the service account email address of the application making the access token request. The scope is a space-delimited list of the permissions that the application requests. (See https://developers.google.com/accounts/docs/OAuth2ServiceAccount )

The subEmail is the email address of the user for which the application is requesting delegated access. The subEmail may be left empty if there is no such email address.

Returns null on failure

More Information and Examples

(.NET Core C#) Get XOAUTH2 Access Token from Google OAuth 2.0 Authorization Server (C#) Get XOAUTH2 Access Token from Google OAuth 2.0 Authorization Server (Mono C#) Get XOAUTH2 Access Token from Google OAuth 2.0 Authorization Server (PowerShell) Get XOAUTH2 Access Token from Google OAuth 2.0 Authorization Server

G_SvcOauthAccessTokenAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task G_SvcOauthAccessTokenAsync(string iss, string scope, string subEmail, int numSec, Cert cert);

Introduced in version 9.5.0.44

Creates an asynchronous task to call the G_SvcOauthAccessToken method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

G_SvcOauthAccessToken2

public string G_SvcOauthAccessToken2(Hashtable claimParams, int numSec, Cert cert);

Introduced in version 9.5.0.51

The same as the G_SvcOauthAccessToken method, but with added flexibility for more customization. The 1st three args of the G_SvcOauthAccessToken are replaced with claimParams allowing for future expansion of name-value params. See the example below.

Returns null on failure

More Information and Examples

(.NET Core C#) Get OAuth 2.0 Access Token using G_SvcOauthAccessToken2 (C#) Get OAuth 2.0 Access Token using G_SvcOauthAccessToken2 (Mono C#) Get OAuth 2.0 Access Token using G_SvcOauthAccessToken2 (PowerShell) Get OAuth 2.0 Access Token using G_SvcOauthAccessToken2

G_SvcOauthAccessToken2Async ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task G_SvcOauthAccessToken2Async(Hashtable claimParams, int numSec, Cert cert);

Introduced in version 9.5.0.51

Creates an asynchronous task to call the G_SvcOauthAccessToken2 method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

GenTimeStamp

public string GenTimeStamp();

Returns the current GMT (also known as UTC) date/time in a string that is compliant with RFC 2616 format.

Returns null on failure

GetCacheRoot

public string GetCacheRoot(int index);

Returns the Nth cache root (indexing begins at 0). Cache roots are set by calling AddCacheRoot one or more times.

Returns null on failure

GetCookieXml

public string GetCookieXml(string domain);

Returns the cookies in XML format for a specific domain. Cookies are only persisted if the SaveCookies property is set to true. If the CookieDir property is set to the keyword "memory", then cookies are saved in-memory.

Returns null on failure

More Information and Examples

(.NET Core C#) Demonstrates how to Get Cookies Sent by the HTTP Server (C#) Demonstrates how to Get Cookies Sent by the HTTP Server (Mono C#) Demonstrates how to Get Cookies Sent by the HTTP Server (PowerShell) Demonstrates how to Get Cookies Sent by the HTTP Server

GetDomain

public string GetDomain(string url);

Utility method for extracting the domain name from a full URL. For example, if "https://www.chilkatsoft.com/default.asp" is the URL passed in, then "www.chilkatsoft.com" is returned.

Returns null on failure

GetHead

public HttpResponse GetHead(string url);

Sends an HTTP HEAD request for a URL and returns a response object. (Note: HEAD requests will never automatically follow redirects.)

Returns null on failure

More Information and Examples

(.NET Core C#) HTTP HEAD Request (C#) HTTP HEAD Request (Mono C#) HTTP HEAD Request (PowerShell) HTTP HEAD Request (.NET Core C#) Get the Last-Modified Date Before HTTP Download (C#) Get the Last-Modified Date Before HTTP Download (Mono C#) Get the Last-Modified Date Before HTTP Download (PowerShell) Get the Last-Modified Date Before HTTP Download (.NET Core C#) Get Size of File on Web Server (C#) Get Size of File on Web Server (Mono C#) Get Size of File on Web Server (PowerShell) Get Size of File on Web Server

GetHeadAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task GetHeadAsync(string url);

Creates an asynchronous task to call the GetHead method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

GetRequestHeader

public string GetRequestHeader(string name);

Returns the value of a header field that has been pre-defined to be sent with all HTTP GET requests issued by the QuickGet and QuickGetStr methods. By default, this includes header fields such as Accept, AcceptCharset, AcceptLanguage, Connection, UserAgent, etc.

Returns null on failure

GetServerSslCert

public Cert GetServerSslCert(string domain, int port);

Establishes an SSL/TLS connection with a web server for the purpose of retrieving the server's SSL certificate (public-key only of course...). Nothing is retrieved from the web server. This method simply makes a connection, gets the certificate information, and closes the connection.

Returns null on failure

More Information and Examples

(.NET Core C#) Get the Server Certificate, Certificate Chain, and Root CA Certificate (C#) Get the Server Certificate, Certificate Chain, and Root CA Certificate (Mono C#) Get the Server Certificate, Certificate Chain, and Root CA Certificate (PowerShell) Get the Server Certificate, Certificate Chain, and Root CA Certificate (.NET Core C#) Get Web Server's SPKI Fingerprint (C#) Get Web Server's SPKI Fingerprint (Mono C#) Get Web Server's SPKI Fingerprint (PowerShell) Get Web Server's SPKI Fingerprint

GetServerSslCertAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task GetServerSslCertAsync(string domain, int port);

Creates an asynchronous task to call the GetServerSslCert method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

GetUrlPath

public string GetUrlPath(string url);

Returns the path part of a URL. The syntax of a URL is <scheme>://<user>:<password>@<host>:<port>/<path>;<params>?<query>#<frag>. This method returns the "path" part.

Returns null on failure

HasRequestHeader

public bool HasRequestHeader(string name);

Returns true if the specified header field is defined such that it will be sent with all GET requests issued by the QuickGet and QuickGetStr methods.

LastJsonData

public JsonObject LastJsonData();

Introduced in version 9.5.0.79

Provides information about what transpired in the last method called on this object instance. For many methods, there is no information. However, for some methods, details about what occurred can be obtained by getting the LastJsonData right after the method call returns.

Returns null on failure

LoadTaskCaller

public bool LoadTaskCaller(Task task);

Introduced in version 9.5.0.80

Loads the caller of the task's async method.

Returns true for success, false for failure.

OcspCheck

public int OcspCheck(string domain, int port);

Introduced in version 9.5.0.84

Gets the server certificate at a domain:port and then sends an OCSP request to the certificate's OCSP URL to determine if the certificate has been revoked. Returns the OCSP status, which has one of the following values:

-1: Unable to check. See the contents of the LastErrorText property for more informaiton.
0: Good
1: Revoked
2: Unknown

More Information and Examples

(.NET Core C#) OCSP Check Domain's Server Certificate Revocation Status (C#) OCSP Check Domain's Server Certificate Revocation Status (Mono C#) OCSP Check Domain's Server Certificate Revocation Status (PowerShell) OCSP Check Domain's Server Certificate Revocation Status

OcspCheckAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task OcspCheckAsync(string domain, int port);

Introduced in version 9.5.0.84

Creates an asynchronous task to call the OcspCheck method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

ParseOcspReply

public int ParseOcspReply(BinData ocspReply, JsonObject replyData);

Introduced in version 9.5.0.75

Parses an OCSP reply. Returns the following possible integer values:

-1: The ocspReply does not contain a valid OCSP reply.
0: Successful - Response has valid confirmations..
1: Malformed request - Illegal confirmation request.
2: Internal error - Internal error in issuer.
3: Try later - Try again later.
4: Not used - This value is never returned.
5: Sig required - Must sign the request.
6: Unauthorized - Request unauthorized.

The binaryOCSP reply is provided in ocspReply. The replyData is populated with data parsed from ocspReply.

More Information and Examples

(.NET Core C#) Validate Certificate using OCSP Protocol (C#) Validate Certificate using OCSP Protocol (Mono C#) Validate Certificate using OCSP Protocol (PowerShell) Validate Certificate using OCSP Protocol

PBinary

public HttpResponse PBinary(string verb, string url, byte[] byteData, string contentType, bool md5, bool gzip);

Introduced in version 9.5.0.45

Sends an HTTP request to the url. The verb can be "POST", "PUT", "PATCH", etc. The body of the HTTP request contains the bytes passed in byteData. The contentType is a content type such as "image/gif", "application/pdf", etc. If md5 is true, then a Content-MD5 header is added with the base64 MD5 hash of the byteData. Servers aware of the Content-MD5 header will perform a message integrity check to ensure that the data has not been corrupted. If gzip is true, the byteData is compressed using the gzip algorithm. The HTTP request body will contain the GZIP compressed data, and a "Content-Encoding: gzip" header is automatically added to indicate that the request data needs to be ungzipped when received (at the server).

Returns null on failure

PBinaryAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task PBinaryAsync(string verb, string url, byte[] byteData, string contentType, bool md5, bool gzip);

Introduced in version 9.5.0.45

Creates an asynchronous task to call the PBinary method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

PBinaryBd

public HttpResponse PBinaryBd(string verb, string url, BinData data, string contentType, bool md5, bool gzip);

Introduced in version 9.5.0.69

The same as PBinary, but the data to be uploaded is passed in data.

Returns null on failure

More Information and Examples

(.NET Core C#) Upload In-Memory Binary Data to Google Cloud Storage (C#) Upload In-Memory Binary Data to Google Cloud Storage (Mono C#) Upload In-Memory Binary Data to Google Cloud Storage (PowerShell) Upload In-Memory Binary Data to Google Cloud Storage

PBinaryBdAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task PBinaryBdAsync(string verb, string url, BinData data, string contentType, bool md5, bool gzip);

Introduced in version 9.5.0.69

Creates an asynchronous task to call the PBinaryBd method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

PFile

public HttpResponse PFile(string verb, string url, string localFilePath, string contentType, bool md5, bool gzip);

Introduced in version 9.5.0.83

Sends an HTTP/HTTPS request to the url. The verb can be "POST", "PUT", "PATCH", etc. The url can begin with "http://" or "https://" depending if TLS is desired. The body of the HTTP request is streamed directly from the localFilePath. The contentType is a content type such as "image/gif", "application/pdf", "text/xml", etc. If md5 is true, then a Content-MD5 header is added with the base64 MD5 hash of the localFilePath. Servers aware of the Content-MD5 header will perform a message integrity check to ensure that the data has not been corrupted. If gzip is true, the localFilePath is compressed using the gzip algorithm. The HTTP request body will contain the GZIP compressed data, and a "Content-Encoding: gzip" header is automatically added to indicate that the request data needs to be ungzipped when received (at the server).

Returns null on failure

More Information and Examples

(.NET Core C#) Create S3 Pre-Signed URL for Upload (C#) Create S3 Pre-Signed URL for Upload (Mono C#) Create S3 Pre-Signed URL for Upload (PowerShell) Create S3 Pre-Signed URL for Upload (.NET Core C#) S3 Upload with Transfer Acceleration (C#) S3 Upload with Transfer Acceleration (Mono C#) S3 Upload with Transfer Acceleration (PowerShell) S3 Upload with Transfer Acceleration

PFileAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task PFileAsync(string verb, string url, string localFilePath, string contentType, bool md5, bool gzip);

Introduced in version 9.5.0.83

Creates an asynchronous task to call the PFile method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

PostBinary

public string PostBinary(string url, byte[] byteData, string contentType, bool md5, bool gzip);

Sends an HTTP POST request to the url. The body of the HTTP request contains the bytes passed in byteData. The contentType is a content type such as "image/gif", "application/pdf", etc. If md5 is true, then a Content-MD5 header is added with the base64 MD5 hash of the byteData. Servers aware of the Content-MD5 header will perform a message integrity check to ensure that the data has not been corrupted. If gzip is true, the byteData is compressed using the gzip algorithm. The HTTP request body will contain the GZIP compressed data, and a "Content-Encoding: gzip" header is automatically added to indicate that the request data needs to be ungzipped when received (at the server).

Returns the text body of the HTTP response if the HTTP response has a success status code. Otherwise the method is considered to have failed. If more details of the HTTP response are required, call PBinary instead (which returns the HTTP response object).

Note: The HTTP response code is available in the LastStatus property. Other properties having information include LastResponseHeader, LastResponseBody, LastModDate, LastContentType, etc.

Returns null on failure

More Information and Examples

(.NET Core C#) HTTP POST with Binary Data in Request Body (C#) HTTP POST with Binary Data in Request Body (Mono C#) HTTP POST with Binary Data in Request Body (PowerShell) HTTP POST with Binary Data in Request Body

PostBinaryAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task PostBinaryAsync(string url, byte[] byteData, string contentType, bool md5, bool gzip);

Creates an asynchronous task to call the PostBinary method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

PostJson

public HttpResponse PostJson(string url, string jsonText);

A simplified way of sending a JSON POST and receiving the JSON response. The HTTP response is returned in an HTTP response object. The content type of the HTTP request is "application/json". To send a JSON POST using a different content-type, call the PostJson2 method where the content type can be explicitly specified.

Returns null on failure

More Information and Examples

HTTP Tutorial - Common HTTP Requests Explained (.NET Core C#) HTTP POST JSON (C#) HTTP POST JSON (Mono C#) HTTP POST JSON (PowerShell) HTTP POST JSON

PostJsonAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task PostJsonAsync(string url, string jsonText);

Creates an asynchronous task to call the PostJson method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

PostJson2

public HttpResponse PostJson2(string url, string contentType, string jsonText);

The same as PostJson,except it allows for the content type to be explicitly provided. The PostJson method automatically uses "application/jsonrequest". If the application needs for the content type to be "application/json", or some other content type, then PostJson2 provides the means.

Returns null on failure

More Information and Examples

(.NET Core C#) HTTP POST JSON (application/json)(C#) HTTP POST JSON (application/json)(Mono C#) HTTP POST JSON (application/json)(PowerShell) HTTP POST JSON (application/json)(.NET Core C#) HttpPostJson2 Example (C#) HttpPostJson2 Example (Mono C#) HttpPostJson2 Example (PowerShell) HttpPostJson2 Example (.NET Core C#) HttpPostJson2Async Example (C#) HttpPostJson2Async Example (Mono C#) HttpPostJson2Async Example (PowerShell) HttpPostJson2Async Example

PostJson2Async ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task PostJson2Async(string url, string contentType, string jsonText);

Creates an asynchronous task to call the PostJson2 method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

PostJson3

public HttpResponse PostJson3(string url, string contentType, JsonObject json);

Introduced in version 9.5.0.68

The same as PostJson2,except a JSON object is passed in for the request body.

Returns null on failure

More Information and Examples

(.NET Core C#) Auth0 Server-to-Server Access Token (Client Credentials flow)(C#) Auth0 Server-to-Server Access Token (Client Credentials flow)(Mono C#) Auth0 Server-to-Server Access Token (Client Credentials flow)(PowerShell) Auth0 Server-to-Server Access Token (Client Credentials flow)

PostJson3Async ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task PostJson3Async(string url, string contentType, JsonObject json);

Introduced in version 9.5.0.68

Creates an asynchronous task to call the PostJson3 method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

PostUrlEncoded

public HttpResponse PostUrlEncoded(string url, HttpRequest req);

Sends a simple URL encoded POST. The form parameters are sent in the body of the HTTP request in x-www-form-urlencoded format. The content-type is "application/x-www-form-urlencoded".

Returns null on failure

More Information and Examples

HTTP Tutorial - Common HTTP Requests Explained (.NET Core C#) Duplicating a Simple HTML Form Submission (POST)(C#) Duplicating a Simple HTML Form Submission (POST)(Mono C#) Duplicating a Simple HTML Form Submission (POST)(PowerShell) Duplicating a Simple HTML Form Submission (POST)(.NET Core C#) HTTP POST x-www-form-urlencoded (C#) HTTP POST x-www-form-urlencoded (Mono C#) HTTP POST x-www-form-urlencoded (PowerShell) HTTP POST x-www-form-urlencoded (.NET Core C#) Debugging HTTP (C#) Debugging HTTP (Mono C#) Debugging HTTP (PowerShell) Debugging HTTP (.NET Core C#) PostUrlEncoded Clarified (C#) PostUrlEncoded Clarified (Mono C#) PostUrlEncoded Clarified (PowerShell) PostUrlEncoded Clarified (.NET Core C#) PostXml vs. PostUrlEncoded (C#) PostXml vs. PostUrlEncoded (Mono C#) PostXml vs. PostUrlEncoded (PowerShell) PostXml vs. PostUrlEncoded (.NET Core C#) URL Encoding Charset in POST Query Params (C#) URL Encoding Charset in POST Query Params (Mono C#) URL Encoding Charset in POST Query Params (PowerShell) URL Encoding Charset in POST Query Params

PostUrlEncodedAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task PostUrlEncodedAsync(string url, HttpRequest req);

Creates an asynchronous task to call the PostUrlEncoded method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

PostXml

public HttpResponse PostXml(string endpointUrl, string xmlContent, string xmlCharset);

A simplified way of posting XML content to a web server. This method is good for making SOAP calls using HTTP POST. The xmlCharset should match the character encoding used in the xmlContent, which is typically "utf-8". The HTTP response is returned in an HTTP response object.

Important: This method sends the POST with a "Content-Type" header value of "application/xml". In rare cases, a server might require the Content-Type header to be "text/xml". To use "text/xml" instead of the default "application/xml", call SetRequestHeader("Content-Type","text/xml") prior to calling this method.

To use HTTPS simply pass an endpointUrl beginning with "https://" instead of "http://". This applies to any Chilkat method where a URL is passed as an argument.

Returns null on failure

More Information and Examples

HTTP Tutorial - Common HTTP Requests Explained (.NET Core C#) Send XMLHttpRequest and Get Response (C#) Send XMLHttpRequest and Get Response (Mono C#) Send XMLHttpRequest and Get Response (PowerShell) Send XMLHttpRequest and Get Response (.NET Core C#) Calling a SOAP Web Service using PostXml (C#) Calling a SOAP Web Service using PostXml (Mono C#) Calling a SOAP Web Service using PostXml (PowerShell) Calling a SOAP Web Service using PostXml (.NET Core C#) Debugging HTTP (C#) Debugging HTTP (Mono C#) Debugging HTTP (PowerShell) Debugging HTTP (.NET Core C#) Send SOAP 1.2 Request to Web Service Requiring Authentication (C#) Send SOAP 1.2 Request to Web Service Requiring Authentication (Mono C#) Send SOAP 1.2 Request to Web Service Requiring Authentication (PowerShell) Send SOAP 1.2 Request to Web Service Requiring Authentication (.NET Core C#) PostXml vs. PostUrlEncoded (C#) PostXml vs. PostUrlEncoded (Mono C#) PostXml vs. PostUrlEncoded (PowerShell) PostXml vs. PostUrlEncoded

PostXmlAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task PostXmlAsync(string endpointUrl, string xmlContent, string xmlCharset);

Creates an asynchronous task to call the PostXml method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

PText

public HttpResponse PText(string verb, string url, string textData, string charset, string contentType, bool md5, bool gzip);

Introduced in version 9.5.0.46

Sends an HTTP request to the url. The verb can be "POST", "PUT", "PATCH", etc. The body of the HTTP request contains the text passed in textData. The contentType is a content type such as "text/xml", "application/json", etc. If md5 is true, then a Content-MD5 header is added with the base64 MD5 hash of the textData. Servers aware of the Content-MD5 header will perform a message integrity check to ensure that the data has not been corrupted. If gzip is true, the contentType is compressed using the gzip algorithm. The HTTP request body will contain the GZIP compressed data, and a "Content-Encoding: gzip" header is automatically added to indicate that the request data needs to be ungzipped when received (at the server).

Returns null on failure

More Information and Examples

(.NET Core C#) Outlook Contacts Update (PATCH) a Contact (C#) Outlook Contacts Update (PATCH) a Contact (Mono C#) Outlook Contacts Update (PATCH) a Contact (PowerShell) Outlook Contacts Update (PATCH) a Contact

PTextAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task PTextAsync(string verb, string url, string textData, string charset, string contentType, bool md5, bool gzip);

Introduced in version 9.5.0.46

Creates an asynchronous task to call the PText method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

PTextSb

public HttpResponse PTextSb(string verb, string url, StringBuilder textData, string charset, string contentType, bool md5, bool gzip);

Introduced in version 9.5.0.69

The same as PText, but the data to be uploaded is passed in textData.

Returns null on failure

More Information and Examples

(.NET Core C#) Upload String to Google Cloud Storage (C#) Upload String to Google Cloud Storage (Mono C#) Upload String to Google Cloud Storage (PowerShell) Upload String to Google Cloud Storage (.NET Core C#) Send GMail with Attachments (C#) Send GMail with Attachments (Mono C#) Send GMail with Attachments (PowerShell) Send GMail with Attachments

PTextSbAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task PTextSbAsync(string verb, string url, StringBuilder textData, string charset, string contentType, bool md5, bool gzip);

Introduced in version 9.5.0.69

Creates an asynchronous task to call the PTextSb method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

PutBinary

public string PutBinary(string url, byte[] byteData, string contentType, bool md5, bool gzip);

Sends an HTTP PUT request to the url. The body of the HTTP request is byteData. The contentType is a content type such as "image/gif", "application/pdf", etc. If md5 is true, then a Content-MD5 header is added with the base64 MD5 hash of the byteData. Servers aware of the Content-MD5 header will perform a message integrity check to ensure that the data has not been corrupted. If gzip is true, the byteData is compressed using the gzip algorithm. The HTTP request body will contain the GZIP compressed data, and a "Content-Encoding: gzip" header is automatically added to indicate that the request data needs to be ungzipped when received (at the server).

Returns the text body of the HTTP response if the HTTP response has a success status code. Otherwise the method is considered to have failed. If more details of the HTTP response are required, call PBinary instead (which returns the HTTP response object).

Returns null on failure

PutBinaryAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task PutBinaryAsync(string url, byte[] byteData, string contentType, bool md5, bool gzip);

Creates an asynchronous task to call the PutBinary method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

PutText

public string PutText(string url, string textData, string charset, string contentType, bool md5, bool gzip);

Sends an HTTP PUT request to the url. The body of the HTTP request is textData. The charset should be set to a charset name such as "iso-8859-1", "windows-1252", "Shift_JIS", "utf-8", etc. The string "ansi" may also be used as a charset name. The contentType is a content type such as "text/plain", "text/xml", etc. If md5 is true, then a Content-MD5 header is added with the base64 MD5 hash of the textData. Servers aware of the Content-MD5 header will perform a message integrity check to ensure that the data has not been corrupted. If gzip is true, the textData is compressed using the gzip algorithm. The HTTP request body will contain the GZIP compressed data, and a "Content-Encoding: gzip" header is automatically added to indicate that the request data needs to be ungzipped when received (at the server).

Returns the text body of the HTTP response if the HTTP response has a success status code. Otherwise the method is considered to have failed. If more details of the HTTP response are required, call PText instead (which returns the HTTP response object).

Returns null on failure

More Information and Examples

(.NET Core C#) HTTP PUT JSON (C#) HTTP PUT JSON (Mono C#) HTTP PUT JSON (PowerShell) HTTP PUT JSON

PutTextAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task PutTextAsync(string url, string textData, string charset, string contentType, bool md5, bool gzip);

Creates an asynchronous task to call the PutText method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

QuickDeleteStr

public string QuickDeleteStr(string url);

Same as QuickGetStr, but uses the HTTP DELETE method instead of the GET method.

Note: The HTTP response code is available in the LastStatus property. Other properties having information include LastResponseHeader, LastResponseBody, LastModDate, LastContentType, etc.

Returns null on failure

More Information and Examples

(.NET Core C#) QuickDeleteStr Example (C#) QuickDeleteStr Example (Mono C#) QuickDeleteStr Example (PowerShell) QuickDeleteStr Example (.NET Core C#) Debugging HTTP (C#) Debugging HTTP (Mono C#) Debugging HTTP (PowerShell) Debugging HTTP

QuickDeleteStrAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task QuickDeleteStrAsync(string url);

Creates an asynchronous task to call the QuickDeleteStr method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

QuickGet

public byte[] QuickGet(string url);

Sends an HTTP GET request for a URL and returns the binary response body. The URL may contain query parameters. If the SendCookies property is true, matching cookies previously persisted to the CookiesDir are automatically included in the request. If the FetchFromCache property is true, the resource may be fetched directly from cache.

Note: The HTTP response code is available in the LastStatus property. Other properties having information include LastResponseHeader, LastResponseBody, LastModDate, LastContentType, etc.

A response code >= 400 is considered a failure. If the error response was textual in nature, then it will also be available in the LastResponseBody property.

Returns an empty byte array on failure

More Information and Examples

(.NET Core C#) Facebook Download all Photos to Local Files (C#) Facebook Download all Photos to Local Files (Mono C#) Facebook Download all Photos to Local Files (PowerShell) Facebook Download all Photos to Local Files (.NET Core C#) Download a Zip from a URL and OpenFromMemory. (No .zip fie is created)(C#) Download a Zip from a URL and OpenFromMemory. (No .zip fie is created)(Mono C#) Download a Zip from a URL and OpenFromMemory. (No .zip fie is created)(PowerShell) Download a Zip from a URL and OpenFromMemory. (No .zip fie is created)

QuickGetAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task QuickGetAsync(string url);

Creates an asynchronous task to call the QuickGet method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

QuickGetBd

public bool QuickGetBd(string url, BinData binData);

Introduced in version 9.5.0.64

The same as QuickGet, but returns the content in a Chilkat BinData object. The existing content of binData, if any, is cleared and replaced with the downloaded content.

A response code >= 400 is considered a failure and the method will return false. However, the error response will still be returned in binData. If the error response was textual in nature, then it will also be available in the LastResponseBody property.

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) QuickGetBd Example (C#) QuickGetBd Example (Mono C#) QuickGetBd Example (PowerShell) QuickGetBd Example (.NET Core C#) Create Enveloping XML Digital Signature (C#) Create Enveloping XML Digital Signature (Mono C#) Create Enveloping XML Digital Signature (PowerShell) Create Enveloping XML Digital Signature

QuickGetBdAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task QuickGetBdAsync(string url, BinData binData);

Introduced in version 9.5.0.64

Creates an asynchronous task to call the QuickGetBd method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

QuickGetObj

public HttpResponse QuickGetObj(string url);

Sends an HTTP GET request for a URL and returns the response object. If the SendCookies property is true, matching cookies previously persisted to the CookiesDir are automatically included in the request. If the FetchFromCache property is true, the page could be fetched directly from cache.

Returns null on failure

More Information and Examples

(.NET Core C#) QuickGetObj Example (C#) QuickGetObj Example (Mono C#) QuickGetObj Example (PowerShell) QuickGetObj Example (.NET Core C#) Getting the HTTP Response after an Asynchronous HTTP Request Completes (C#) Getting the HTTP Response after an Asynchronous HTTP Request Completes (Mono C#) Getting the HTTP Response after an Asynchronous HTTP Request Completes (PowerShell) Getting the HTTP Response after an Asynchronous HTTP Request Completes

QuickGetObjAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task QuickGetObjAsync(string url);

Creates an asynchronous task to call the QuickGetObj method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

QuickGetSb

public bool QuickGetSb(string url, StringBuilder sbContent);

Introduced in version 9.5.0.64

The same as QuickGetStr, but returns the content in a Chilkat StringBuilder object. The existing content of sbContent, if any, is cleared and replaced with the downloaded content.

If the response status code is >= 400, then this method returns false, but the body of the HTTP response is still returned in sbContent. This allows for the application to examine the response body for cases where an error is returned, but the expected content is not received.

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) Load XML from a Remote URL (C#) Load XML from a Remote URL (Mono C#) Load XML from a Remote URL (PowerShell) Load XML from a Remote URL

QuickGetSbAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task QuickGetSbAsync(string url, StringBuilder sbContent);

Introduced in version 9.5.0.64

Creates an asynchronous task to call the QuickGetSb method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

QuickGetStr

public string QuickGetStr(string url);

Sends an HTTP GET request for a URL and returns the response body as a string. The URL may contain query parameters. If the SendCookies property is true, matching cookies previously persisted to the CookiesDir are automatically included in the request. If the FetchFromCache property is true, the page could be fetched directly from cache. If the HTTP request fails, a null value is returned and error information can be found in the LastErrorText, LastErrorXml, or LastErrorHtml properties.

Note: The HTTP response code is available in the LastStatus property. Other properties having information include LastResponseHeader, LastResponseBody, LastModDate, LastContentType, etc.

Returns null on failure

More Information and Examples

(.NET Core C#) HTTP GET - Download HTML or any Text Content to a String (C#) HTTP GET - Download HTML or any Text Content to a String (Mono C#) HTTP GET - Download HTML or any Text Content to a String (PowerShell) HTTP GET - Download HTML or any Text Content to a String (.NET Core C#) HTTPS GET using SSL/TLS (C#) HTTPS GET using SSL/TLS (Mono C#) HTTPS GET using SSL/TLS (PowerShell) HTTPS GET using SSL/TLS (.NET Core C#) HTTPS GET URL with URL Encoded Query Params (C#) HTTPS GET URL with URL Encoded Query Params (Mono C#) HTTPS GET URL with URL Encoded Query Params (PowerShell) HTTPS GET URL with URL Encoded Query Params

QuickGetStrAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task QuickGetStrAsync(string url);

Creates an asynchronous task to call the QuickGetStr method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

QuickPutStr

public string QuickPutStr(string url);

Same as QuickGetStr, but uses the HTTP PUT method instead of the GET method.

Note: The HTTP response code is available in the LastStatus property. Other properties having information include LastResponseHeader, LastResponseBody, LastModDate, LastContentType, etc.

Returns null on failure

More Information and Examples

(.NET Core C#) Debugging HTTP (C#) Debugging HTTP (Mono C#) Debugging HTTP (PowerShell) Debugging HTTP

QuickPutStrAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task QuickPutStrAsync(string url);

Creates an asynchronous task to call the QuickPutStr method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

QuickRequest

public HttpResponse QuickRequest(string verb, string url);

Introduced in version 9.5.0.77

Sends an HTTP request with no body for a URL and returns the response object. The verb is typically "GET" or "DELETE".

If the SendCookies property is true, matching cookies previously persisted to the CookiesDir are automatically included in the request. If the FetchFromCache property is true, the page could be fetched directly from cache.

Returns null on failure

More Information and Examples

(.NET Core C#) QuickRequest Method - GET and DELETE (C#) QuickRequest Method - GET and DELETE (Mono C#) QuickRequest Method - GET and DELETE (PowerShell) QuickRequest Method - GET and DELETE

QuickRequestAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task QuickRequestAsync(string verb, string url);

Introduced in version 9.5.0.77

Creates an asynchronous task to call the QuickRequest method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

QuickRequestParams

public HttpResponse QuickRequestParams(string verb, string url, JsonObject json);

Introduced in version 9.5.0.89

This is the same as the QuickRequest method, except query params can be provided as non-URL-encoded name/value members in the json.

Returns null on failure

More Information and Examples

(.NET Core C#) Demonstrates the Http.QuickRequestParams Method (C#) Demonstrates the Http.QuickRequestParams Method (Mono C#) Demonstrates the Http.QuickRequestParams Method (PowerShell) Demonstrates the Http.QuickRequestParams Method (.NET Core C#) QR Code Generator via api.qrserver.com REST API (C#) QR Code Generator via api.qrserver.com REST API (Mono C#) QR Code Generator via api.qrserver.com REST API (PowerShell) QR Code Generator via api.qrserver.com REST API

QuickRequestParamsAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task QuickRequestParamsAsync(string verb, string url, JsonObject json);

Introduced in version 9.5.0.89

Creates an asynchronous task to call the QuickRequestParams method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

RemoveRequestHeader

public void RemoveRequestHeader(string name);

Removes a header from the internal list of custom header field name/value pairs to be automatically added when HTTP requests are sent via methods that do not use the HTTP request object. (The SetRequestHeader method is called to add custom header fields.)

RenderGet

public string RenderGet(string url);

Same as QuickGet, but does not send the HTTP GET. Instead, it builds the HTTP request that would've been sent and returns it.

Returns null on failure

More Information and Examples

(.NET Core C#) RenderGet Example (C#) RenderGet Example (Mono C#) RenderGet Example (PowerShell) RenderGet Example

ResumeDownload

public bool ResumeDownload(string url, string targetFilename);

Same as the Download method, except a failed download may be resumed. The targetFilename is automatically checked and if it exists, the download will resume at the point where it previously failed. ResumeDownload may be called any number of times until the full download is complete.

Returns true for success, false for failure.

ResumeDownloadAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task ResumeDownloadAsync(string url, string targetFilename);

Creates an asynchronous task to call the ResumeDownload method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

ResumeDownloadBd

public bool ResumeDownloadBd(string url, BinData binData);

Introduced in version 9.5.0.75

Same as the DownloadBd method, except a failed download may be resumed. The download will resume at a point based on the number of bytes already contained in binData. ResumeDownloadBd may be called any number of times until the full download is complete.

The incoming data is appended to binData.

Returns true for success, false for failure.

ResumeDownloadBdAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task ResumeDownloadBdAsync(string url, BinData binData);

Introduced in version 9.5.0.75

Creates an asynchronous task to call the ResumeDownloadBd method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_CreateBucket

public bool S3_CreateBucket(string bucketPath);

Creates a new Amazon S3 bucket.

Note: x-amz-* headers, including metadata, can be added to any S3 request by adding each header with a call to SetRequestHeader. This applies to all S3 methods, even if not explicitly stated.

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) S3 Create Bucket Example (C#) S3 Create Bucket Example (Mono C#) S3 Create Bucket Example (PowerShell) S3 Create Bucket Example

S3_CreateBucketAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_CreateBucketAsync(string bucketPath);

Creates an asynchronous task to call the S3_CreateBucket method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_DeleteBucket

public bool S3_DeleteBucket(string bucketPath);

Deletes an Amazon S3 bucket.

Note: If the bucket is in a region different than us-east-1, makes sure to set the AwsEndpoint property to the correct region, such as "eu-central-1". Also, if using an S3 compatible service such as Wasabi, always set the AwsEndpoint property. For example: "s3.wasabisys.com", "s3.eu-central-1.wasabisys.com".

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) S3 Delete Bucket (C#) S3 Delete Bucket (Mono C#) S3 Delete Bucket (PowerShell) S3 Delete Bucket

S3_DeleteBucketAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_DeleteBucketAsync(string bucketPath);

Creates an asynchronous task to call the S3_DeleteBucket method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_DeleteMultipleObjects

public HttpResponse S3_DeleteMultipleObjects(string bucketName, StringArray objectNames);

Introduced in version 9.5.0.47

Deletes multiple objects from a bucket using a single HTTP request. The bucketName contains the names (also known as "keys") of the objects to be deleted. To delete a specific version of an object, append a versionId attribute to the object name. For example: "SampleDocument.txt; VersionId="OYcLXagmS.WaD..oyH4KRguB95_YhLs7""

Returns null on failure

More Information and Examples

(.NET Core C#) Delete Multiple Objects Example (C#) Delete Multiple Objects Example (Mono C#) Delete Multiple Objects Example (PowerShell) Delete Multiple Objects Example

S3_DeleteMultipleObjectsAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_DeleteMultipleObjectsAsync(string bucketName, StringArray objectNames);

Introduced in version 9.5.0.47

Creates an asynchronous task to call the S3_DeleteMultipleObjects method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_DeleteObject

public bool S3_DeleteObject(string bucketPath, string objectName);

Deletes a remote file (object) on the Amazon S3 service.

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) S3 Delete File (C#) S3 Delete File (Mono C#) S3 Delete File (PowerShell) S3 Delete File

S3_DeleteObjectAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_DeleteObjectAsync(string bucketPath, string objectName);

Creates an asynchronous task to call the S3_DeleteObject method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_DownloadBd

public bool S3_DownloadBd(string bucketPath, string objectName, BinData bd);

Introduced in version 9.5.0.76

The same as DownloadFile, except the downloaded file data is appended to bd.

Note: If the bucket is in a region different than us-east-1, makes sure to set the AwsEndpoint property to the correct region, such as "eu-central-1". Also, if using an S3 compatible service such as Wasabi, always set the AwsEndpoint property. For example: "s3.wasabisys.com", "s3.eu-central-1.wasabisys.com".

Returns true for success, false for failure.

S3_DownloadBdAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_DownloadBdAsync(string bucketPath, string objectName, BinData bd);

Introduced in version 9.5.0.76

Creates an asynchronous task to call the S3_DownloadBd method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_DownloadBytes

public byte[] S3_DownloadBytes(string bucketPath, string objectName);

The same as DownloadFile, except the file data is returned directly in-memory instead of being written to a local file.

Returns an empty byte array on failure

More Information and Examples

(.NET Core C#) Demonstrate S3_DownloadBytes (C#) Demonstrate S3_DownloadBytes (Mono C#) Demonstrate S3_DownloadBytes (PowerShell) Demonstrate S3_DownloadBytes

S3_DownloadBytesAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_DownloadBytesAsync(string bucketPath, string objectName);

Creates an asynchronous task to call the S3_DownloadBytes method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_DownloadFile

public bool S3_DownloadFile(string bucketPath, string objectName, string localFilePath);

Downloads a file from the Amazon S3 service.

Note: If the bucket is in a region different than us-east-1, makes sure to set the AwsEndpoint property to the correct region, such as "eu-central-1". Also, if using an S3 compatible service such as Wasabi, always set the AwsEndpoint property. For example: "s3.wasabisys.com", "s3.eu-central-1.wasabisys.com".

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) S3 Download File Example (C#) S3 Download File Example (Mono C#) S3 Download File Example (PowerShell) S3 Download File Example

S3_DownloadFileAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_DownloadFileAsync(string bucketPath, string objectName, string localFilePath);

Creates an asynchronous task to call the S3_DownloadFile method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_DownloadString

public string S3_DownloadString(string bucketPath, string objectName, string charset);

Downloads a text file (object) from the Amazon S3 service directly into a string variable. The charset specifies the character encoding, such as "utf-8", of the remote text object.

Note: If the bucket is in a region different than us-east-1, makes sure to set the AwsEndpoint property to the correct region, such as "eu-central-1". Also, if using an S3 compatible service such as Wasabi, always set the AwsEndpoint property. For example: "s3.wasabisys.com", "s3.eu-central-1.wasabisys.com".

Returns null on failure

More Information and Examples

(.NET Core C#) S3 Download String Object (C#) S3 Download String Object (Mono C#) S3 Download String Object (PowerShell) S3 Download String Object

S3_DownloadStringAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_DownloadStringAsync(string bucketPath, string objectName, string charset);

Creates an asynchronous task to call the S3_DownloadString method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_FileExists

public int S3_FileExists(string bucketPath, string objectName);

Determines if a remote object (file) exists. Returns 1 if the file exists, 0 if it does not exist, -1 if there was a failure in checking, or 2 if using in asynchronous mode to indicate that the background task was successfully started.

Note: If the bucket is in a region different than us-east-1, makes sure to set the AwsEndpoint property to the correct region, such as "eu-central-1". Also, if using an S3 compatible service such as Wasabi, always set the AwsEndpoint property. For example: "s3.wasabisys.com", "s3.eu-central-1.wasabisys.com".

More Information and Examples

(.NET Core C#) Read S3 Object Metadata of File Already Uploaded to S3 (C#) Read S3 Object Metadata of File Already Uploaded to S3 (Mono C#) Read S3 Object Metadata of File Already Uploaded to S3 (PowerShell) Read S3 Object Metadata of File Already Uploaded to S3

S3_FileExistsAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_FileExistsAsync(string bucketPath, string objectName);

Creates an asynchronous task to call the S3_FileExists method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_GenerateUrl

public string S3_GenerateUrl(string bucket, string path, CkDateTime expire);

Introduced in version 9.5.0.46

Generates a temporary pre-signed URL for Amazon S3 using AWS Signature V2. (Call S3_GenerateUrlV4 to generate AWS Signature V4 pre-signed URLs.) Requires that the AwsSecretKey and AwsAccessKey be set to valid values prior to calling this method.

Note: This method can only generate URLs that are for HTTP GET requests (i.e. URLs you can paste into a browser address bar). This method does not generate URLs for POST, PUT, DELETE, etc.

Returns null on failure

More Information and Examples

(.NET Core C#) Generate S3 Signed URL (C#) Generate S3 Signed URL (Mono C#) Generate S3 Signed URL (PowerShell) Generate S3 Signed URL

S3_GenerateUrlV4

public string S3_GenerateUrlV4(bool useHttps, string bucketName, string path, int numSecondsValid, string awsService);

Introduced in version 9.5.0.66

Note: The S3_GenPresignedUrl method is new in Chilkat v9.5.0.83 and can create S3 pre-signed URLs for GET, POST, PUT, DELETE, or any other HTTP verb.

Generates a temporary pre-signed URL for Amazon S3 using AWS Signature V4. (Call S3_GenerateUrl to generate AWS Signature V2 pre-signed URLs.) Requires that the AwsSecretKey, AwsAccessKey, and AwsRegion properties be set to valid values prior to calling this method. Also requires the AwsEndpoint property to be set if the endpoint is different than "s3.amazonaws.com".

The URL that is generated has this format:

https://<AwsEndpoint>/<bucket_name>/<path>
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=<AwsAccessKey>/<currentDate>/<AwsRegion>/<awsService>/aws4_request
&X-Amz-Date=<currentDateTime>
&X-Amz-Expires=<numSecondsValid>
&X-Amz-SignedHeaders=host
&X-Amz-Signature=<signature-value>

The awsService is a string naming the AWS service, such as "s3". If useHttps is true, then the URL begins with "https://", otherwise it begins with "http://".

Note: This method can only generate URLs that are for HTTP GET requests (i.e. URLs you can paste into a browser address bar). This method does not generate URLs for POST, PUT, DELETE, etc.

Returns null on failure

More Information and Examples

(.NET Core C#) Generate an AWS (S3) Pre-Signed URL using Signature V4 (C#) Generate an AWS (S3) Pre-Signed URL using Signature V4 (Mono C#) Generate an AWS (S3) Pre-Signed URL using Signature V4 (PowerShell) Generate an AWS (S3) Pre-Signed URL using Signature V4

S3_GenPresignedUrl

public string S3_GenPresignedUrl(string httpVerb, bool useHttps, string bucketName, string path, int numSecondsValid, string awsService);

Introduced in version 9.5.0.83

Generates a temporary pre-signed URL for Amazon S3 using AWS Signature V4. Requires that the AwsSecretKey, AwsAccessKey, and AwsRegion properties be set to valid values prior to calling this method. Also requires the AwsEndpoint property to be set if the endpoint is different than "s3.amazonaws.com".

The URL that is generated has this format:

https://<AwsEndpoint>/<bucket_name>/<path>
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=<AwsAccessKey>/<currentDate>/<AwsRegion>/<awsService>/aws4_request
&X-Amz-Date=<currentDateTime>
&X-Amz-Expires=<numSecondsValid>
&X-Amz-SignedHeaders=host
&X-Amz-Signature=<signature-value>

The httpVerb is the HTTP verb such as "GET", "PUT", "POST", "DELETE", etc. The awsService is a string naming the AWS service, such as "s3" or "s3-accelerate". If useHttps is true, then the URL begins with "https://", otherwise it begins with "http://".

Returns null on failure

More Information and Examples

(.NET Core C#) Create S3 Pre-Signed URL for Upload (C#) Create S3 Pre-Signed URL for Upload (Mono C#) Create S3 Pre-Signed URL for Upload (PowerShell) Create S3 Pre-Signed URL for Upload (.NET Core C#) S3 Upload with Transfer Acceleration (C#) S3 Upload with Transfer Acceleration (Mono C#) S3 Upload with Transfer Acceleration (PowerShell) S3 Upload with Transfer Acceleration

S3_ListBucketObjects

public string S3_ListBucketObjects(string bucketPath);

Retrieves the XML listing of the objects contained within an Amazon S3 bucket. (This is like a directory listing, but in XML format.)

The bucketPath name may be qualified with URL-encoded params. For example, to list the objects in a bucket named "ChilkatABC" with max-keys = 2000 and marker = "xyz", call S3_ListBucketObject passing the following string for bucketPath: "ChilkatABC?max-keys=2000&marker=xyz"

The S3_ListBucketObjects method recognized all params listed in the AWS documentation for listing objects in a bucket: delimiter, marker, max-keys, and prefix. See Amazon's AWS online documentation for more information.

Returns null on failure

More Information and Examples

(.NET Core C#) S3 List Objects in Bucket (C#) S3 List Objects in Bucket (Mono C#) S3 List Objects in Bucket (PowerShell) S3 List Objects in Bucket

S3_ListBucketObjectsAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_ListBucketObjectsAsync(string bucketPath);

Creates an asynchronous task to call the S3_ListBucketObjects method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_ListBuckets

public string S3_ListBuckets();

Retrieves the XML listing of the buckets for an Amazon S3 account.

Returns null on failure

More Information and Examples

(.NET Core C#) S3 List Buckets Example (C#) S3 List Buckets Example (Mono C#) S3 List Buckets Example (PowerShell) S3 List Buckets Example

S3_ListBucketsAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_ListBucketsAsync();

Creates an asynchronous task to call the S3_ListBuckets method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_UploadBd

public bool S3_UploadBd(BinData bd, string contentType, string bucketPath, string objectName);

Introduced in version 9.5.0.76

The same as S3_UploadFile, except the contents of the file come from bd instead of a local file.

Note: x-amz-* headers, including metadata, can be added to any S3 request by adding each header with a call to SetRequestHeader. This applies to all S3 methods, even if not explicitly stated.

Note: If the bucket is in a region different than us-east-1, makes sure to set the AwsEndpoint property to the correct region, such as "eu-central-1". Also, if using an S3 compatible service such as Wasabi, always set the AwsEndpoint property. For example: "s3.wasabisys.com", "s3.eu-central-1.wasabisys.com".

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) Backblaze S3 Upload Binary (C#) Backblaze S3 Upload Binary (Mono C#) Backblaze S3 Upload Binary (PowerShell) Backblaze S3 Upload Binary

S3_UploadBdAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_UploadBdAsync(BinData bd, string contentType, string bucketPath, string objectName);

Introduced in version 9.5.0.76

Creates an asynchronous task to call the S3_UploadBd method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_UploadBytes

public bool S3_UploadBytes(byte[] contentBytes, string contentType, string bucketPath, string objectName);

The same as S3_UploadFile, except the contents of the file come from contentBytes instead of a local file.

Note: x-amz-* headers, including metadata, can be added to any S3 request by adding each header with a call to SetRequestHeader. This applies to all S3 methods, even if not explicitly stated.

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) Demonstrate S3_UploadBytes (C#) Demonstrate S3_UploadBytes (Mono C#) Demonstrate S3_UploadBytes (PowerShell) Demonstrate S3_UploadBytes

S3_UploadBytesAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_UploadBytesAsync(byte[] contentBytes, string contentType, string bucketPath, string objectName);

Creates an asynchronous task to call the S3_UploadBytes method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_UploadFile

public bool S3_UploadFile(string localFilePath, string contentType, string bucketPath, string objectName);

Uploads a file to the Amazon S3 service.

Note: x-amz-* headers, including metadata, can be added to any S3 request by adding each header with a call to SetRequestHeader. This applies to all S3 methods, even if not explicitly stated.

Note: If the bucket is in a region different than us-east-1, makes sure to set the AwsEndpoint property to the correct region, such as "eu-central-1". Also, if using an S3 compatible service such as Wasabi, always set the AwsEndpoint property. For example: "s3.wasabisys.com", "s3.eu-central-1.wasabisys.com".

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) S3 Upload File (C#) S3 Upload File (Mono C#) S3 Upload File (PowerShell) S3 Upload File (.NET Core C#) Wasabi Upload File (C#) Wasabi Upload File (Mono C#) Wasabi Upload File (PowerShell) Wasabi Upload File

S3_UploadFileAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_UploadFileAsync(string localFilePath, string contentType, string bucketPath, string objectName);

Creates an asynchronous task to call the S3_UploadFile method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

S3_UploadString

public bool S3_UploadString(string objectContent, string charset, string contentType, string bucketPath, string objectName);

Uploads an in-memory string to the Amazon S3 service. This is the same as UploadFile, except that the file contents are from an in-memory string instead of a local file. Internal to this method, the objectContent is converted to the character encoding specified by charset prior to uploading.

Note: x-amz-* headers, including metadata, can be added to any S3 request by adding each header with a call to SetRequestHeader. This applies to all S3 methods, even if not explicitly stated.

Note: If the bucket is in a region different than us-east-1, makes sure to set the AwsEndpoint property to the correct region, such as "eu-central-1". Also, if using an S3 compatible service such as Wasabi, always set the AwsEndpoint property. For example: "s3.wasabisys.com", "s3.eu-central-1.wasabisys.com".

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) S3 Upload String (C#) S3 Upload String (Mono C#) S3 Upload String (PowerShell) S3 Upload String

S3_UploadStringAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task S3_UploadStringAsync(string objectContent, string charset, string contentType, string bucketPath, string objectName);

Creates an asynchronous task to call the S3_UploadString method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

SetAuthPrivateKey

public bool SetAuthPrivateKey(string publicKeyId, PrivateKey privKey);

Introduced in version 9.5.0.89

Sets the private key to be used with some forms of authentication. Starting in v9.5.0.89, this is used automatically add the Authorization header (Signature) for Amazon Pay requests.

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) Amazon Pay Examples (C#) Amazon Pay Examples (Mono C#) Amazon Pay Examples (PowerShell) Amazon Pay Examples

SetAuthTokenSb

public bool SetAuthTokenSb(StringBuilder sb);

Introduced in version 9.5.0.95

Sets the AuthToken property. The sb contains the OAuth2 access token to be used.

Returns true for success, false for failure.

SetCookieXml

public bool SetCookieXml(string domain, string cookieXml);

Restores cookies for a particular domain. It is assumed that the cookie XML was previously retrieved via the GetCookieXml method, and saved to some sort of persistent storage, such as within a database table. It is then possible for an application to restore the cookies by calling this method.

Returns true for success, false for failure.

SetOAuthRsaKey

public bool SetOAuthRsaKey(PrivateKey privKey);

Introduced in version 9.5.0.39

Sets the RSA key to be used with OAuth authentication when the RSA-SHA1 OAuth signature method is used (see the OAuthSigMethod property).

Returns true for success, false for failure.

SetRequestHeader

public void SetRequestHeader(string headerFieldName, string headerFieldValue);

Adds a custom header field to any HTTP request sent by a method that does not use the HTTP request object. These methods include Download, DownloadAppend, GetHead, PostBinary, PostXml, PutBinary, PutText, QuickDeleteStr, QuickGet, QuickGetObj, QuickGetStr, QuickPutStr, XmlRpc, and XmlRpcPut.

Cookies may be explictly added by calling this method passing "Cookie" for the headerFieldName.

The RemoveRequestHeader method can be called to remove a custom header.

Note1: Do not call this method to add Basic authentication, i.e. "Authorization: Basic ....". Instead, set the Login and Password properties, and also set the BasicAuth property = true. Chilkat will add the "Authorization: Basic ..." header using the correct format automatically.

Note 2: Never explicitly set the Content-Length header field. Chilkat will automatically compute the correct length and add the Content-Length header to all POST, PUT, or any other request where the Content-Length needs to be specified. (GET requests always have a 0 length body, and therefore never need a Content-Length header field.)

Note 3: To add more than one header, call this method once per header field.

Note 4:: Passing an empty value string causes the header to be removed. This was the unfortunate behavior of the method from the beginning, and cannot be changed for backward compatibility reasons. A workaround exists starting in v9.5.0.82 by adding the "AllowEmptyHeaders" keyword to the UncommonOptions property.

More Information and Examples

(.NET Core C#) Add Custom Header to HTTP GET (C#) Add Custom Header to HTTP GET (Mono C#) Add Custom Header to HTTP GET (PowerShell) Add Custom Header to HTTP GET

SetSecurePassword

public bool SetSecurePassword(SecureString password);

Introduced in version 9.5.0.76

Equivalent to setting the Password property, but provides for a more secure way of passing the password in a secure string object.

Returns true for success, false for failure.

SetSslCertRequirement

public void SetSslCertRequirement(string reqName, string reqValue);

Introduced in version 9.5.0.84

Enforces a requirement on the server's certificate. The reqName can be one of the following:

SubjectDN
SubjectCN
IssuerDN
IssuerCN
SAN (added in v9.5.0.84)

The reqName specifies the part of the certificate, and the reqValue is the value that it must match exactly or with a wildcard (*). If the server's certificate does not match, the SSL / TLS connection is aborted.

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) Require SSL Server Certificate Domain Match (C#) Require SSL Server Certificate Domain Match (Mono C#) Require SSL Server Certificate Domain Match (PowerShell) Require SSL Server Certificate Domain Match

SetSslClientCert

public bool SetSslClientCert(Cert cert);

Allows for a client-side certificate to be used for an SSL connection.

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) HTTP TLS Mutual Authentication (Client-Side Certificate)(C#) HTTP TLS Mutual Authentication (Client-Side Certificate)(Mono C#) HTTP TLS Mutual Authentication (Client-Side Certificate)(PowerShell) HTTP TLS Mutual Authentication (Client-Side Certificate)(.NET Core C#) Use Installed Cert on Windows for TLS Client Authentication (C#) Use Installed Cert on Windows for TLS Client Authentication (Mono C#) Use Installed Cert on Windows for TLS Client Authentication (PowerShell) Use Installed Cert on Windows for TLS Client Authentication (.NET Core C#) Rabobank GET /v3/accounts (C#) Rabobank GET /v3/accounts (Mono C#) Rabobank GET /v3/accounts (PowerShell) Rabobank GET /v3/accounts (.NET Core C#) HTTPS Mutual Authentication using Smartcard or Token (C#) HTTPS Mutual Authentication using Smartcard or Token (Mono C#) HTTPS Mutual Authentication using Smartcard or Token (PowerShell) HTTPS Mutual Authentication using Smartcard or Token

SetSslClientCertPem

public bool SetSslClientCertPem(string pemDataOrPath, string pemPassword);

Allows for a client-side certificate + private key to be used for the SSL / TLS connection (often called 2-way SSL).

Returns true for success, false for failure.

More Information and Examples

How to Create a PEM that Contains Certificates and a Private Key (.NET Core C#) HTTP TLS Mutual Authentication (Client-Side Certificate)(C#) HTTP TLS Mutual Authentication (Client-Side Certificate)(Mono C#) HTTP TLS Mutual Authentication (Client-Side Certificate)(PowerShell) HTTP TLS Mutual Authentication (Client-Side Certificate)

SetSslClientCertPfx

public bool SetSslClientCertPfx(string pfxPath, string pfxPassword);

Allows for a client-side certificate + private key to be used for the SSL / TLS connection (often called 2-way SSL).

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) HTTP TLS Mutual Authentication (Client-Side Certificate)(C#) HTTP TLS Mutual Authentication (Client-Side Certificate)(Mono C#) HTTP TLS Mutual Authentication (Client-Side Certificate)(PowerShell) HTTP TLS Mutual Authentication (Client-Side Certificate)

SetUrlVar

public bool SetUrlVar(string name, string value);

Introduced in version 9.5.0.67

Sets the value of a variable for substitutions in URLs passed to any method. Variables can appear in URLs in the following format: {$varName}. For example: https://graph.microsoft.com/v1.0/users/{$id}

Returns true for success, false for failure.

SharePointOnlineAuth

public bool SharePointOnlineAuth(string siteUrl, string username, SecureString password, JsonObject extraInfo);

Introduced in version 9.5.0.73

Authenticates with SharePoint Online, resulting in a cookie being set and used for subsequent SharePoint HTTP requests. Prior to calling this method, an application should set the CookieDir property to either "memory" or a directory path to persist the SharePoint authentication cookie to be automatically used in subsequent runs.

This method has the side-effect of setting the SaveCookies and SendCookies properties to true, because these settings are required for SharePoint Online authentication.

The siteUrl is a URL such as "https://yourdomain.sharepoint.com/". The username is an email address such as "username@yourdomain.com". The extraInfo is reserved for providing additional information as needed in the future.

Returns true for success, false for failure.

More Information and Examples

(.NET Core C#) SharePoint Online Authentication (C#) SharePoint Online Authentication (Mono C#) SharePoint Online Authentication (PowerShell) SharePoint Online Authentication

SharePointOnlineAuthAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task SharePointOnlineAuthAsync(string siteUrl, string username, SecureString password, JsonObject extraInfo);

Introduced in version 9.5.0.73

Creates an asynchronous task to call the SharePointOnlineAuth method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

SleepMs

public void SleepMs(int millisec);

Convenience method to force the calling process to sleep for a number of milliseconds.

SynchronousRequest

public HttpResponse SynchronousRequest(string domain, int port, bool ssl, HttpRequest req);

Sends an explicit HttpRequest to an HTTP server and returns an HttpResponse object. The HttpResponse object provides full access to the response including all headers and the response body. This method may be used to send POST requests, as well as GET, HEAD, file uploads, and XMLHTTP. To send via HTTPS (i.e. TLS), set the ssl property = true. Otherwise set it to false.

NOTE: The 1st argument of this method is a domain, not a URL. For example, DO NOT pass "https://www.somedomain.com/" in the 1st argument. Instead, pass "www.somedomain.com".

The Parts of a URL

http://example.com:8042/over/there?name=ferret#nose
\__/   \______________/\_________/ \________/ \__/
 |           |            |            |        |
scheme   domain+port     path        query   fragment

Returns null on failure

More Information and Examples

HTTP Tutorial - Common HTTP Requests Explained How URL Syntax Relates to SynchronousRequest (.NET Core C#) WebDAV PROPFIND using SynchronousRequest (C#) WebDAV PROPFIND using SynchronousRequest (Mono C#) WebDAV PROPFIND using SynchronousRequest (PowerShell) WebDAV PROPFIND using SynchronousRequest (.NET Core C#) Simple HTTP POST (C#) Simple HTTP POST (Mono C#) Simple HTTP POST (PowerShell) Simple HTTP POST (.NET Core C#) Debugging HTTP (C#) Debugging HTTP (Mono C#) Debugging HTTP (PowerShell) Debugging HTTP (.NET Core C#) Send XMLHttpRequest using PUT, GET, DELETE, or any HTTP Request Method (C#) Send XMLHttpRequest using PUT, GET, DELETE, or any HTTP Request Method (Mono C#) Send XMLHttpRequest using PUT, GET, DELETE, or any HTTP Request Method (PowerShell) Send XMLHttpRequest using PUT, GET, DELETE, or any HTTP Request Method (.NET Core C#) Adding Cookies to an HTTP Request (C#) Adding Cookies to an HTTP Request (Mono C#) Adding Cookies to an HTTP Request (PowerShell) Adding Cookies to an HTTP Request (.NET Core C#) HTTP multipart/form-data Upload (C#) HTTP multipart/form-data Upload (Mono C#) HTTP multipart/form-data Upload (PowerShell) HTTP multipart/form-data Upload (.NET Core C#) Parse a URL into its Component Parts (C#) Parse a URL into its Component Parts (Mono C#) Parse a URL into its Component Parts (PowerShell) Parse a URL into its Component Parts (.NET Core C#) SOAP with MTOM XOP Attachment (C#) SOAP with MTOM XOP Attachment (Mono C#) SOAP with MTOM XOP Attachment (PowerShell) SOAP with MTOM XOP Attachment

SynchronousRequestAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell) (.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task SynchronousRequestAsync(string domain, int port, bool ssl, HttpRequest req);

Creates an asynchronous task to call the SynchronousRequest method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

More Information and Examples

(.NET Core C#) Asynchronous HTTP SOAP 1.2 Request and Response using POST (C#) Asynchronous HTTP SOAP 1.2 Request and Response using POST (Mono C#) Asynchronous HTTP SOAP 1.2 Request and Response using POST

UrlDecode

public string UrlDecode(string str);

URL decodes a string.

Returns null on failure

UrlEncode

public string UrlEncode(string str);

URL encodes a string.

Returns null on failure

VerifyTimestampReply

public int VerifyTimestampReply(BinData timestampReply, Cert tsaCert);

Introduced in version 9.5.0.75

Verifies a timestamp reply received from a timestamp authority (TSA). Returns the following possible integer values:

-1: The timestampReply does not contain a valid timestamp reply.
-2: The timestampReply is a valid timestamp reply, but failed verification using the public key of the tsaCert.
0: Granted and verified.
1: Granted and verified, with mods (see RFC 3161)
2: Rejected.
3: Waiting.
4: Revocation Warning
5: Revocation Notification

If the timestamp reply (timestampReply) is known to be from a trusted source, then the tsaCert may be empty. If tsaCert is empty (never loaded with a certificate), then the verification will use the certificate embedded in the timestamp reply.

More Information and Examples

(.NET Core C#) RFC3161 Timestamp Client - Fetch from Timestamp Authority (TSA) and Verify (C#) RFC3161 Timestamp Client - Fetch from Timestamp Authority (TSA) and Verify (Mono C#) RFC3161 Timestamp Client - Fetch from Timestamp Authority (TSA) and Verify (PowerShell) RFC3161 Timestamp Client - Fetch from Timestamp Authority (TSA) and Verify

XmlRpc

public string XmlRpc(string urlEndpoint, string xmlIn);

Makes an XML RPC call to a URL endpoint. The XML string is passed in an HTTP POST, and the XML response is returned.

Returns null on failure

More Information and Examples

(.NET Core C#) HTTP XMLRPC Example (C#) HTTP XMLRPC Example (Mono C#) HTTP XMLRPC Example (PowerShell) HTTP XMLRPC Example

XmlRpcAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task XmlRpcAsync(string urlEndpoint, string xmlIn);

Creates an asynchronous task to call the XmlRpc method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

XmlRpcPut

public string XmlRpcPut(string urlEndpoint, string xmlIn);

Same as XmlRpc, but uses the HTTP PUT method instead of the POST method.

Returns null on failure

XmlRpcPutAsync ^{(.NET Core C#) (C#) (Mono C#) (PowerShell)}

public Task XmlRpcPutAsync(string urlEndpoint, string xmlIn);

Creates an asynchronous task to call the XmlRpcPut method with the arguments provided. (Async methods are available starting in Chilkat v9.5.0.52.)

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns null on failure

Events

AbortCheck

public event AbortCheckEventHandler OnAbortCheck;

Provides the opportunity for a method call to be aborted. The AbortCheck event is fired periodically based on the value of the HeartbeatMs property. If HeartbeatMs is 0, then no AbortCheck events will fire. As an example, to fire 5 AbortCheck events per second, set the HeartbeatMs property equal to 200.

Chilkat .NET Event Implementation

Args are passed using Chilkat.AbortCheckEventArgs

Event callback implementation:

private void http_OnAbortCheck(object sender, Chilkat.AbortCheckEventArgs args)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
http.OnAbortCheck += http_OnAbortCheck;

Chilkat Mono/.NET Core Event Implementation

Event callback implementation:

public void handleAbortCheck(out bool abort)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
// ...
Chilkat.Http.AbortCheck abortCheck = new Chilkat.Http.AbortCheck(handleAbortCheck);
http.setAbortCheckCb(abortCheck);

HttpBeginReceive

public event HttpBeginReceiveEventHandler OnHttpBeginReceive;

This event is fired just before beginning to read the HTTP response.

Chilkat .NET Event Implementation

Event callback implementation:

void http_OnHttpBeginReceive(object sender, EventArgs args)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
http.OnHttpBeginReceive += http_OnHttpBeginReceive;

Chilkat Mono/.NET Core Event Implementation

Event callback implementation:

public void handleHttpBeginReceive()
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
// ...
Chilkat.Http.HttpBeginReceive httpBeginReceive = new Chilkat.Http.HttpBeginReceive(handleHttpBeginReceive);
http.setHttpBeginReceiveCb(httpBeginReceive);

HttpBeginSend

public event HttpBeginSendEventHandler OnHttpBeginSend;

This event is fired just before the HTTP request is about to be sent.

Chilkat .NET Event Implementation

Event callback implementation:

void http_OnHttpBeginSend(object sender, EventArgs args)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
http.OnHttpBeginSend += http_OnHttpBeginSend;

Chilkat Mono/.NET Core Event Implementation

Event callback implementation:

public void handleHttpBeginSend()
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
// ...
Chilkat.Http.HttpBeginSend httpBeginSend = new Chilkat.Http.HttpBeginSend(handleHttpBeginSend);
http.setHttpBeginSendCb(httpBeginSend);

HttpChunked

public event HttpChunkedEventHandler OnHttpChunked;

Called when the received response is in chunked format.

Chilkat .NET Event Implementation

Event callback implementation:

void http_OnHttpChunked(object sender, EventArgs args)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
http.OnHttpChunked += http_OnHttpChunked;

Chilkat Mono/.NET Core Event Implementation

Event callback implementation:

public void handleHttpChunked()
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
// ...
Chilkat.Http.HttpChunked httpChunked = new Chilkat.Http.HttpChunked(handleHttpChunked);
http.setHttpChunkedCb(httpChunked);

HttpEndReceive

public event HttpEndReceiveEventHandler OnHttpEndReceive;

This event is fired after the complete HTTP response has been received.

Chilkat .NET Event Implementation

Args are passed using Chilkat.StatusEventArgs

Event callback implementation:

private void http_OnHttpEndReceive(object sender, Chilkat.StatusEventArgs args)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
http.OnHttpEndReceive += http_OnHttpEndReceive;

Chilkat Mono/.NET Core Event Implementation

Event callback implementation:

public void handleHttpEndReceive(bool success)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
// ...
Chilkat.Http.HttpEndReceive httpEndReceive = new Chilkat.Http.HttpEndReceive(handleHttpEndReceive);
http.setHttpEndReceiveCb(httpEndReceive);

HttpEndSend

public event HttpEndSendEventHandler OnHttpEndSend;

This event is fired after the complete HTTP request has been sent.

Chilkat .NET Event Implementation

Args are passed using Chilkat.StatusEventArgs

Event callback implementation:

private void http_OnHttpEndSend(object sender, Chilkat.StatusEventArgs args)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
http.OnHttpEndSend += http_OnHttpEndSend;

Chilkat Mono/.NET Core Event Implementation

Event callback implementation:

public void handleHttpEndSend(bool success)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
// ...
Chilkat.Http.HttpEndSend httpEndSend = new Chilkat.Http.HttpEndSend(handleHttpEndSend);
http.setHttpEndSendCb(httpEndSend);

HttpRedirect

public event HttpRedirectEventHandler OnHttpRedirect;

Called for each redirect that is followed. The abort may be set to true to abort the HTTP request.

Chilkat .NET Event Implementation

Args are passed using Chilkat.HttpRedirectEventArgs

Event callback implementation:

private void http_OnHttpRedirect(object sender, Chilkat.HttpRedirectEventArgs args)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
http.OnHttpRedirect += http_OnHttpRedirect;

Chilkat Mono/.NET Core Event Implementation

Event callback implementation:

public void handleHttpRedirect(string originalUrl, string redirectUrl, out bool abort)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
// ...
Chilkat.Http.HttpRedirect httpRedirect = new Chilkat.Http.HttpRedirect(handleHttpRedirect);
http.setHttpRedirectCb(httpRedirect);

PercentDone

public event PercentDoneEventHandler OnPercentDone;

Provides the percentage completed for any method that involves network communications or time-consuming processing (assuming it is a method where a percentage completion can be measured). This event is only fired when it is possible to know a percentage completion, and when it makes sense to express the operation as a percentage completed. The pctDone argument will have a value from 1 to 100. For operations (Chilkat method calls) that complete very quickly, the number of PercentDone callbacks will vary, but the final callback should have a value of 100. For long running operations, no more than one callback per percentage point will occur (for example: 1, 2, 3, ... 98, 99, 100).

The PercentDone callback counts as an AbortCheck event. For method calls that complete quickly such that PercentDone events fire, it may be that AbortCheck events don't fire because the opportunity to abort is already provided in the PercentDone callback. For time consuming operations, where the amount of time between PercentDone callbacks are long, AbortCheck callbacks may be used to allow for the operation to be aborted in a more responsive manner.

The abort output argument provides a means for aborting the operation. Setting it to true will cause the method to abort and return a failed status (or whatever return value indicates failure).

Chilkat .NET Event Implementation

Args are passed using Chilkat.PercentDoneEventArgs

Event callback implementation:

private void http_OnPercentDone(object sender, Chilkat.PercentDoneEventArgs args)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
http.OnPercentDone += http_OnPercentDone;

Chilkat Mono/.NET Core Event Implementation

Event callback implementation:

public void handlePercentDone(int pctDone, out bool abort)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
// ...
Chilkat.Http.PercentDone percentDone = new Chilkat.Http.PercentDone(handlePercentDone);
http.setPercentDoneCb(percentDone);

ProgressInfo

public event ProgressInfoEventHandler OnProgressInfo;

A general name/value event that provides information about what is happening during a method call. To find out what information is available, write code to handle this event and log the name/value pairs. Most are self-explanatory.

Chilkat .NET Event Implementation

Args are passed using Chilkat.ProgressInfoEventArgs

Event callback implementation:

private void http_OnProgressInfo(object sender, Chilkat.ProgressInfoEventArgs args)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
http.OnProgressInfo += http_OnProgressInfo;

Chilkat Mono/.NET Core Event Implementation

Event callback implementation:

public void handleProgressInfo(string name, string value)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
// ...
Chilkat.Http.ProgressInfo progressInfo = new Chilkat.Http.ProgressInfo(handleProgressInfo);
http.setProgressInfoCb(progressInfo);

ReceiveRate

public event ReceiveRateEventHandler OnReceiveRate;

Periodicallly called with information about the download performance (i.e. the receiving of the HTTP response). The byteCount is the cumulative number of bytes downloaded so far. The bytesPerSec is the current transfer rate in bytes per second.

Chilkat .NET Event Implementation

Args are passed using Chilkat.DataRateEventArgs

Event callback implementation:

private void http_OnReceiveRate(object sender, Chilkat.DataRateEventArgs args)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
http.OnReceiveRate += http_OnReceiveRate;

Chilkat Mono/.NET Core Event Implementation

Event callback implementation:

public void handleReceiveRate(long byteCount, uint bytesPerSec)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
// ...
Chilkat.Http.ReceiveRate receiveRate = new Chilkat.Http.ReceiveRate(handleReceiveRate);
http.setReceiveRateCb(receiveRate);

SendRate

public event SendRateEventHandler OnSendRate;

Called periodically with upload progress information: The byteCount is the cumulative number of bytes uploaded so far. The bytesPerSec is the current transfer rate in bytes per second.

Chilkat .NET Event Implementation

Args are passed using Chilkat.DataRateEventArgs

Event callback implementation:

private void http_OnSendRate(object sender, Chilkat.DataRateEventArgs args)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
http.OnSendRate += http_OnSendRate;

Chilkat Mono/.NET Core Event Implementation

Event callback implementation:

public void handleSendRate(long byteCount, uint bytesPerSec)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
// ...
Chilkat.Http.SendRate sendRate = new Chilkat.Http.SendRate(handleSendRate);
http.setSendRateCb(sendRate);

TaskCompleted

public event TaskCompletedEventHandler OnTaskCompleted;

Called in the background thread when an asynchronous task completes.

More Information and Examples

C# .NET Framework TaskCompleted Event Callback Example C# .NET Core TaskCompleted Event Callback Example

Chilkat .NET Event Implementation

Args are passed using Chilkat.TaskCompletedEventArgs

Event callback implementation:

private void http_OnTaskCompleted(object sender, Chilkat.TaskCompletedEventArgs args)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
http.OnTaskCompleted += http_OnTaskCompleted;

Chilkat Mono/.NET Core Event Implementation

Event callback implementation:

public void handleTaskIdCompleted(int taskId)
	{
	    // application code goes here.
	}

To add an event handler:

Chilkat.Http http = new Chilkat.Http();
// ...
Chilkat.Http.TaskIdCompleted taskIdCompleted = new Chilkat.Http.TaskIdCompleted(handleTaskIdCompleted);
http.setTaskIdCompletedCb(taskIdCompleted);

top