HttpsURLConnection Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
HttpsURLConnection extends HttpURLConnection
with support for https-specific features.
[Android.Runtime.Register("javax/net/ssl/HttpsURLConnection", DoNotGenerateAcw=true)]
public abstract class HttpsURLConnection : Java.Net.HttpURLConnection[<Android.Runtime.Register("javax/net/ssl/HttpsURLConnection", DoNotGenerateAcw=true)>]
type HttpsURLConnection = class
inherit HttpURLConnection- Inheritance
- Attributes
Remarks
HttpsURLConnection extends HttpURLConnection with support for https-specific features.
See http://www.w3.org/pub/WWW/Protocols/ and RFC 2818 for more details on the https specification.
This class uses HostnameVerifier and SSLSocketFactory. There are default implementations defined for both classes. However, the implementations can be replaced on a per-class (static) or per-instance basis. All new HttpsURLConnections instances will be assigned the "default" static values at instance creation, but they can be overriden by calling the appropriate per-instance set method(s) before connecting.
Added in 1.4.
Java documentation for javax.net.ssl.HttpsURLConnection.
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.
Constructors
| HttpsURLConnection(IntPtr, JniHandleOwnership) |
A constructor used when creating managed representations of JNI objects; called by the runtime. |
| HttpsURLConnection(URL) |
Creates an |
Fields
| HttpAccepted |
Obsolete.
HTTP Status-Code 202: Accepted. (Inherited from HttpURLConnection) |
| HttpBadGateway |
Obsolete.
HTTP Status-Code 502: Bad Gateway. (Inherited from HttpURLConnection) |
| HttpBadMethod |
Obsolete.
HTTP Status-Code 405: Method Not Allowed. (Inherited from HttpURLConnection) |
| HttpBadRequest |
Obsolete.
HTTP Status-Code 400: Bad Request. (Inherited from HttpURLConnection) |
| HttpClientTimeout |
Obsolete.
HTTP Status-Code 408: Request Time-Out. (Inherited from HttpURLConnection) |
| HttpConflict |
Obsolete.
HTTP Status-Code 409: Conflict. (Inherited from HttpURLConnection) |
| HttpCreated |
Obsolete.
HTTP Status-Code 201: Created. (Inherited from HttpURLConnection) |
| HttpEntityTooLarge |
Obsolete.
HTTP Status-Code 413: Request Entity Too Large. (Inherited from HttpURLConnection) |
| HttpForbidden |
Obsolete.
HTTP Status-Code 403: Forbidden. (Inherited from HttpURLConnection) |
| HttpGatewayTimeout |
Obsolete.
HTTP Status-Code 504: Gateway Timeout. (Inherited from HttpURLConnection) |
| HttpGone |
Obsolete.
HTTP Status-Code 410: Gone. (Inherited from HttpURLConnection) |
| HttpInternalError |
Obsolete.
HTTP Status-Code 500: Internal Server Error. (Inherited from HttpURLConnection) |
| HttpLengthRequired |
Obsolete.
HTTP Status-Code 411: Length Required. (Inherited from HttpURLConnection) |
| HttpMovedPerm |
Obsolete.
HTTP Status-Code 301: Moved Permanently. (Inherited from HttpURLConnection) |
| HttpMovedTemp |
Obsolete.
HTTP Status-Code 302: Temporary Redirect. (Inherited from HttpURLConnection) |
| HttpMultChoice |
Obsolete.
HTTP Status-Code 300: Multiple Choices. (Inherited from HttpURLConnection) |
| HttpNoContent |
Obsolete.
HTTP Status-Code 204: No Content. (Inherited from HttpURLConnection) |
| HttpNotAcceptable |
Obsolete.
HTTP Status-Code 406: Not Acceptable. (Inherited from HttpURLConnection) |
| HttpNotAuthoritative |
Obsolete.
HTTP Status-Code 203: Non-Authoritative Information. (Inherited from HttpURLConnection) |
| HttpNotFound |
Obsolete.
HTTP Status-Code 404: Not Found. (Inherited from HttpURLConnection) |
| HttpNotImplemented |
Obsolete.
HTTP Status-Code 501: Not Implemented. (Inherited from HttpURLConnection) |
| HttpNotModified |
Obsolete.
HTTP Status-Code 304: Not Modified. (Inherited from HttpURLConnection) |
| HttpOk |
Obsolete.
HTTP Status-Code 200: OK. (Inherited from HttpURLConnection) |
| HttpPartial |
Obsolete.
HTTP Status-Code 206: Partial Content. (Inherited from HttpURLConnection) |
| HttpPaymentRequired |
Obsolete.
HTTP Status-Code 402: Payment Required. (Inherited from HttpURLConnection) |
| HttpPreconFailed |
Obsolete.
HTTP Status-Code 412: Precondition Failed. (Inherited from HttpURLConnection) |
| HttpProxyAuth |
Obsolete.
HTTP Status-Code 407: Proxy Authentication Required. (Inherited from HttpURLConnection) |
| HttpReqTooLong |
Obsolete.
HTTP Status-Code 414: Request-URI Too Large. (Inherited from HttpURLConnection) |
| HttpReset |
Obsolete.
HTTP Status-Code 205: Reset Content. (Inherited from HttpURLConnection) |
| HttpSeeOther |
Obsolete.
HTTP Status-Code 303: See Other. (Inherited from HttpURLConnection) |
| HttpServerError |
Obsolete.
HTTP Status-Code 500: Internal Server Error. (Inherited from HttpURLConnection) |
| HttpUnauthorized |
Obsolete.
HTTP Status-Code 401: Unauthorized. (Inherited from HttpURLConnection) |
| HttpUnavailable |
Obsolete.
HTTP Status-Code 503: Service Unavailable. (Inherited from HttpURLConnection) |
| HttpUnsupportedType |
Obsolete.
HTTP Status-Code 415: Unsupported Media Type. (Inherited from HttpURLConnection) |
| HttpUseProxy |
Obsolete.
HTTP Status-Code 305: Use Proxy. (Inherited from HttpURLConnection) |
| HttpVersion |
Obsolete.
HTTP Status-Code 505: HTTP Version Not Supported. (Inherited from HttpURLConnection) |
Properties
| AllowUserInteraction |
Returns the value of the |
| ChunkLength |
The chunk-length when using chunked encoding streaming mode for output. (Inherited from HttpURLConnection) |
| CipherSuite |
Returns the name of the cipher suite negotiated during the SSL handshake. |
| Class |
Returns the runtime class of this |
| Connected |
If |
| ConnectTimeout |
Returns setting for connect timeout. -or- Sets a specified timeout value, in milliseconds, to be used when opening a communications link to the resource referenced by this URLConnection. (Inherited from URLConnection) |
| Content |
Retrieves the contents of this URL connection. (Inherited from URLConnection) |
| ContentEncoding |
Returns the value of the |
| ContentLength |
Returns the value of the |
| ContentLengthLong |
Returns the value of the |
| ContentType |
Returns the value of the |
| Date |
Returns the value of the |
| DefaultHostnameVerifier |
Gets the default |
| DefaultSSLSocketFactory |
Gets the default static |
| DefaultUseCaches |
Returns the default value of a |
| DoInput |
Returns the value of this |
| DoOutput |
Returns the value of this |
| ErrorStream |
Returns the error stream if the connection failed but the server sent useful data nonetheless. (Inherited from HttpURLConnection) |
| Expiration |
Returns the value of the |
| FixedContentLength |
The fixed content-length when using fixed-length streaming mode. (Inherited from HttpURLConnection) |
| FixedContentLengthLong |
The fixed content-length when using fixed-length streaming mode. (Inherited from HttpURLConnection) |
| Handle |
The handle to the underlying Android instance. (Inherited from Object) |
| HeaderFields |
Returns an unmodifiable Map of the header fields. (Inherited from URLConnection) |
| HostnameVerifier |
Gets the |
| IfModifiedSince |
Returns the value of this object's |
| InputStream |
Returns an input stream that reads from this open connection. (Inherited from URLConnection) |
| InstanceFollowRedirects |
Returns the value of this |
| JniIdentityHashCode | (Inherited from Object) |
| JniPeerMembers | |
| LastModified |
Returns the value of the |
| LocalPrincipal |
Returns the principal that was sent to the server during handshaking. |
| Method |
The HTTP method (GET,POST,PUT,etc. (Inherited from HttpURLConnection) |
| OutputStream |
Returns an output stream that writes to this connection. (Inherited from URLConnection) |
| PeerPrincipal |
Returns the server's principal which was established as part of defining the session. |
| PeerReference | (Inherited from Object) |
| Permission |
Returns a permission object representing the permission necessary to make the connection represented by this object. (Inherited from URLConnection) |
| ReadTimeout |
Returns setting for read timeout. -or- Sets the read timeout to a specified timeout, in milliseconds. (Inherited from URLConnection) |
| RequestMethod |
Get the request method. -or- Set the method for the URL request, one of: <UL> <LI>GET <LI>POST <LI>HEAD <LI>OPTIONS <LI>PUT <LI>DELETE <LI>TRACE </UL> are legal, subject to protocol restrictions. (Inherited from HttpURLConnection) |
| RequestProperties |
Returns an unmodifiable Map of general request properties for this connection. (Inherited from URLConnection) |
| ResponseCode |
Gets the status code from an HTTP response message. (Inherited from HttpURLConnection) |
| ResponseMessage |
Gets the HTTP response message, if any, returned along with the response code from a server. (Inherited from HttpURLConnection) |
| SSLSocketFactory |
Gets the SSL socket factory to be used when creating sockets
for secure https URL connections. -or- Sets the |
| ThresholdClass |
This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. |
| ThresholdType |
This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. |
| Url |
The URL represents the remote object on the World Wide Web to which this connection is opened. (Inherited from URLConnection) |
| URL |
Returns the value of this |
| UseCaches |
Returns the value of this |
Methods
| AddRequestProperty(String, String) |
Adds a general request property specified by a key-value pair. (Inherited from URLConnection) |
| Clone() |
Creates and returns a copy of this object. (Inherited from Object) |
| Connect() |
Opens a communications link to the resource referenced by this URL, if such a connection has not already been established. (Inherited from URLConnection) |
| ConnectAsync() | (Inherited from URLConnection) |
| Disconnect() |
Indicates that other requests to the server are unlikely in the near future. (Inherited from HttpURLConnection) |
| Dispose() | (Inherited from Object) |
| Dispose(Boolean) | (Inherited from Object) |
| Equals(Object) |
Indicates whether some other object is "equal to" this one. (Inherited from Object) |
| GetContent(Class[]) |
Retrieves the contents of this URL connection. (Inherited from URLConnection) |
| GetHashCode() |
Returns a hash code value for the object. (Inherited from Object) |
| GetHeaderField(Int32) |
Returns the value for the |
| GetHeaderField(String) |
Returns the value of the named header field. (Inherited from URLConnection) |
| GetHeaderFieldDate(String, Int64) |
Returns the value of the named field parsed as date. (Inherited from URLConnection) |
| GetHeaderFieldInt(String, Int32) |
Returns the value of the named field parsed as a number. (Inherited from URLConnection) |
| GetHeaderFieldKey(Int32) |
Returns the key for the |
| GetHeaderFieldLong(String, Int64) |
Returns the value of the named field parsed as a number. (Inherited from URLConnection) |
| GetLocalCertificates() |
Returns the certificate(s) that were sent to the server during handshaking. |
| GetRequestProperty(String) |
Returns the value of the named general request property for this connection. (Inherited from URLConnection) |
| GetServerCertificates() |
Returns the server's certificate chain which was established as part of defining the session. |
| JavaFinalize() |
Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. (Inherited from Object) |
| Notify() |
Wakes up a single thread that is waiting on this object's monitor. (Inherited from Object) |
| NotifyAll() |
Wakes up all threads that are waiting on this object's monitor. (Inherited from Object) |
| SetChunkedStreamingMode(Int32) |
This method is used to enable streaming of a HTTP request body without internal buffering, when the content length is <b>not</b> known in advance. (Inherited from HttpURLConnection) |
| SetFixedLengthStreamingMode(Int32) |
This method is used to enable streaming of a HTTP request body without internal buffering, when the content length is known in advance. (Inherited from HttpURLConnection) |
| SetFixedLengthStreamingMode(Int64) |
This method is used to enable streaming of a HTTP request body without internal buffering, when the content length is known in advance. (Inherited from HttpURLConnection) |
| SetHandle(IntPtr, JniHandleOwnership) |
Sets the Handle property. (Inherited from Object) |
| SetRequestProperty(String, String) |
Sets the general request property. (Inherited from URLConnection) |
| ToArray<T>() | (Inherited from Object) |
| ToString() |
Returns a string representation of the object. (Inherited from Object) |
| UnregisterFromRuntime() | (Inherited from Object) |
| UsingProxy() |
Indicates if the connection is going through a proxy. (Inherited from HttpURLConnection) |
| Wait() |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>. (Inherited from Object) |
| Wait(Int64, Int32) |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object) |
| Wait(Int64) |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object) |
Explicit Interface Implementations
| IJavaPeerable.Disposed() | (Inherited from Object) |
| IJavaPeerable.DisposeUnlessReferenced() | (Inherited from Object) |
| IJavaPeerable.Finalized() | (Inherited from Object) |
| IJavaPeerable.JniManagedPeerState | (Inherited from Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) | (Inherited from Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) | (Inherited from Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) | (Inherited from Object) |
Extension Methods
| JavaCast<TResult>(IJavaObject) |
Performs an Android runtime-checked type conversion. |
| JavaCast<TResult>(IJavaObject) | |
| GetJniTypeName(IJavaPeerable) | |