Interface IHttpSettings
Interface for the global settings, as the DefaultValue attributes are set this CAN be used with Dapplo.Config.
Best example would be:
[IniSection("Network"), Display(Description = "Network / HTTP Settings")]
public interface IHttpConfig : IHttpSettings, IIniSection {
}
(Yes, it's can be empty, the settings are in the IHttpSettings interface) and than assign the generated instance to
HttpExtensionsGlobals
Namespace: Dapplo.HttpExtensions
Assembly: Dapplo.HttpExtensions.dll
Syntax
public interface IHttpSettings
Properties
| Improve this Doc View SourceAllowAutoRedirect
For more details, click here
Declaration
[Display(Description = "When true a connection would automatically redirect, if the server says so")]
[DataMember(EmitDefaultValue = true)]
bool AllowAutoRedirect { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
AllowPipelining
For more details, click here
Declaration
[Display(Description = "When true, pipelined connections are allowed")]
bool AllowPipelining { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
AuthenticationLevel
In mutual authentication, both the client and server present credentials to establish their identity. The MutualAuthRequired and MutualAuthRequested values are relevant for Kerberos authentication. Kerberos authentication can be supported directly, or can be used if the Negotiate security protocol is used to select the actual security protocol. For more information about authentication protocols, see Internet Authentication For more details, click here
Declaration
[Display(Description = "The level of authentication and impersonation used for every request")]
AuthenticationLevel AuthenticationLevel { get; set; }
Property Value
Type | Description |
---|---|
AuthenticationLevel |
ClientCertificateOptions
For more details, click here
Declaration
[Display(Description = "A value that indicates if the certificate is automatically picked from the certificate store or if the caller is allowed to pass in a specific client certificate.")]
ClientCertificateOption ClientCertificateOptions { get; set; }
Property Value
Type | Description |
---|---|
ClientCertificateOption |
ClientCertificates
Add your client certificates here, so they are passed to the handler.
Declaration
[IgnoreDataMember]
X509CertificateCollection ClientCertificates { get; set; }
Property Value
Type | Description |
---|---|
System.Security.Cryptography.X509Certificates.X509CertificateCollection |
ContinueTimeout
For more details, click here
Declaration
[DataMember(EmitDefaultValue = true)]
[Display(Description = "The amount of time (with milliseconds) the application will wait for 100-continue from the server before uploading data")]
TimeSpan ContinueTimeout { get; set; }
Property Value
Type | Description |
---|---|
TimeSpan |
Credentials
For more details, click here
Declaration
[Display(Description = "The credentials for the request, only used when UseDefaultCredentials is set to false")]
ICredentials Credentials { get; set; }
Property Value
Type | Description |
---|---|
ICredentials |
DefaultDecompressionMethods
For more details, click here
Declaration
[Display(Description = "Decompression methods used")]
DecompressionMethods DefaultDecompressionMethods { get; set; }
Property Value
Type | Description |
---|---|
DecompressionMethods |
DefaultUserAgent
The default User-Agent value to use, a lot of services don't like it when this is empty or the behaviour depends on the value
Declaration
[Display(Description = "The default User-Agent value to use, a lot of services don't like it when this is empty or the behaviour depends on the value")]
string DefaultUserAgent { get; set; }
Property Value
Type | Description |
---|---|
System.String |
Expect100Continue
When true the configured proxy will used the default user credentials
Declaration
[Display(Description = "When true the configured proxy will used the default user credentials")]
[DataMember(EmitDefaultValue = true)]
bool Expect100Continue { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
IgnoreSslCertificateErrors
If true SSL Certificate checks are ignored.
Declaration
[Display(Description = "If true SSL Certificate checks are ignored.")]
[DataMember(EmitDefaultValue = true)]
bool IgnoreSslCertificateErrors { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
ImpersonationLevel
The impersonation level determines how the server can use the client's credentials. For more details, click here
Declaration
[Display(Description = "The impersonation level determines how the server can use the client's credentials")]
TokenImpersonationLevel ImpersonationLevel { get; set; }
Property Value
Type | Description |
---|---|
TokenImpersonationLevel |
MaxAutomaticRedirections
Declaration
[Display(Description = "The maximum amount of redirections that are followed")]
int MaxAutomaticRedirections { get; set; }
Property Value
Type | Description |
---|---|
System.Int32 |
MaxRequestContentBufferSize
For more details, click here
Declaration
[Display(Description = "Max request content buffer size")]
long MaxRequestContentBufferSize { get; set; }
Property Value
Type | Description |
---|---|
System.Int64 |
MaxResponseContentBufferSize
For more details, click here
Declaration
[Display(Description = "Max response content buffer size")]
long MaxResponseContentBufferSize { get; set; }
Property Value
Type | Description |
---|---|
System.Int64 |
MaxResponseHeadersLength
For more details, click here Default would have been 64, this is increased to 256
Declaration
[Display(Description = "The max length, in kilobytes (1024 bytes), of the response headers")]
int MaxResponseHeadersLength { get; set; }
Property Value
Type | Description |
---|---|
System.Int32 |
PreAuthenticate
Declaration
[Display(Description = "When true the request is directly send with a HTTP Authorization header.")]
[DataMember(EmitDefaultValue = true)]
bool PreAuthenticate { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
ProxyBypassList
For more details, click here
Declaration
[Display(Description = "The bypass list for the proxy, only used when UseDefaultProxy is set to false (and UseProxy is true)")]
string[] ProxyBypassList { get; set; }
Property Value
Type | Description |
---|---|
System.String[] |
ProxyBypassOnLocal
For more details, click here
Declaration
[Display(Description = "When set to true, all local addresses will bypass the proxy")]
bool ProxyBypassOnLocal { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
ProxyCredentials
For more details, click here
Declaration
[Display(Description = "The credentials for the proxy, only used when UseDefaultCredentialsForProxy is set to false")]
ICredentials ProxyCredentials { get; set; }
Property Value
Type | Description |
---|---|
ICredentials |
ProxyUri
The Uri for the proxy to use, when the UseDefaultProxy is set to false
Declaration
[Display(Description = "When true the configured proxy will used the default user credentials")]
Uri ProxyUri { get; set; }
Property Value
Type | Description |
---|---|
Uri |
ReadWriteTimeout
For more details, click here
Declaration
[Display(Description = "The number of milliseconds before the writing or reading times out")]
[DataMember(EmitDefaultValue = true)]
int ReadWriteTimeout { get; set; }
Property Value
Type | Description |
---|---|
System.Int32 |
RequestCacheLevel
For more details, click here Default is RequestCacheLevel.Default
Declaration
[Display(Description = "The cache level for the request, to turn off caching use BypassCache.")]
[DataMember(EmitDefaultValue = true)]
RequestCacheLevel RequestCacheLevel { get; set; }
Property Value
Type | Description |
---|---|
RequestCacheLevel |
RequestTimeout
For more details, click here
Declaration
[Display(Description = "Request timeout")]
[DataMember(EmitDefaultValue = true)]
TimeSpan RequestTimeout { get; set; }
Property Value
Type | Description |
---|---|
TimeSpan |
UseCookies
Declaration
[Display(Description = "Should requests store & resend cookies?")]
[DataMember(EmitDefaultValue = true)]
bool UseCookies { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
UseDefaultCredentials
When true every http request will supply the default user credentials when the server asks for them
Declaration
[Display(Description = "When true every http request will supply the default user credentials when the server asks for them")]
[DataMember(EmitDefaultValue = true)]
bool UseDefaultCredentials { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
UseDefaultCredentialsForProxy
When true the configured proxy will used the default user credentials
Declaration
[Display(Description = "When true the configured proxy will used the default user credentials")]
[DataMember(EmitDefaultValue = true)]
bool UseDefaultCredentialsForProxy { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
UseDefaultProxy
When true the default system proxy is used
Declaration
[Display(Description = "When true the default system proxy is used")]
[DataMember(EmitDefaultValue = true)]
bool UseDefaultProxy { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
UseProxy
If true, every request is made via the configured or default proxy
Declaration
[Display(Description = "If true, every request is made via the configured or default proxy")]
[DataMember(EmitDefaultValue = true)]
bool UseProxy { get; set; }
Property Value
Type | Description |
---|---|
System.Boolean |
Methods
| Improve this Doc View SourceShallowClone()
Make a memberwise clone of the object, this is "shallow".
Declaration
IHttpSettings ShallowClone()
Returns
Type | Description |
---|---|
IHttpSettings | "Shallow" Cloned instance of IChangeableHttpBehaviour |