WebRequest.Create Método

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Inicializa um novo WebRequest.

Sobrecargas

Create(String)	Obsoleto. Inicializa uma nova instância de WebRequest com o esquema de URI especificado.
Create(Uri)	Obsoleto. Inicializa uma nova instância de WebRequest com o esquema de URI especificado.

Create(String)

Origem:

WebRequest.cs

Cuidado

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.

Inicializa uma nova instância de WebRequest com o esquema de URI especificado.

public:
 static System::Net::WebRequest ^ Create(System::String ^ requestUriString);

[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.WebRequest Create (string requestUriString);

[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : string -> System.Net.WebRequest

Public Shared Function Create (requestUriString As String) As WebRequest

Parâmetros

requestUriString

String

O URI que identifica o recurso da Internet.

Retornos

WebRequest

Um descendente de WebRequest para o esquema de URI específico.

Atributos

ObsoleteAttribute

Exceções

NotSupportedException

O esquema de solicitação especificado em requestUriString não foi registrado.

ArgumentNullException

requestUriString é null.

SecurityException

O chamador não tem a permissão WebPermissionAttribute para se conectar ao URI solicitado ou a um URI a que a solicitação é redirecionada.

UriFormatException

O URI especificado em requestUriString não é um URI válido.

Observação: no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, FormatException, em vez disso.

Exemplos

O exemplo a seguir usa Create para instanciar uma HttpWebRequest instância. Uma cadeia de caracteres que representa a URL de destino é usada como o parâmetro do construtor.

Uri^ ourUri = gcnew Uri( url );

// Create a 'WebRequest' object with the specified url.
WebRequest^ myWebRequest = WebRequest::Create( url );

// Send the 'WebRequest' and wait for response.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

// Use "ResponseUri" property to get the actual Uri from where the response was attained.
if ( ourUri->Equals( myWebResponse->ResponseUri ) )
{
   Console::WriteLine( "\nRequest Url : {0} was not redirected", url );
}
else
{
   Console::WriteLine( "\nRequest Url : {0} was redirected to {1}", url, myWebResponse->ResponseUri );
}

// Release resources of response object.
myWebResponse->Close();

Uri ourUri = new Uri(url);            

// Create a 'WebRequest' object with the specified url. 
WebRequest myWebRequest = WebRequest.Create(url); 

// Send the 'WebRequest' and wait for response.
WebResponse myWebResponse = myWebRequest.GetResponse(); 

// Use "ResponseUri" property to get the actual Uri from where the response was attained.
if (ourUri.Equals(myWebResponse.ResponseUri))
    Console.WriteLine("\nRequest Url : {0} was not redirected",url);   
else
    Console.WriteLine("\nRequest Url : {0} was redirected to {1}",url,myWebResponse.ResponseUri);   
// Release resources of response object.
myWebResponse.Close();

Dim ourUri As New Uri(url)
' Create a 'WebRequest' object with the specified url. 

Dim myWebRequest As WebRequest = WebRequest.Create(url)

' Send the 'WebRequest' and wait for response.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

' "ResponseUri" property is used to get the actual Uri from where the response was attained.
If ourUri.Equals(myWebResponse.ResponseUri) Then
    Console.WriteLine(ControlChars.Cr + "Request Url : {0} was not redirected", url)
Else
    Console.WriteLine(ControlChars.Cr + "Request Url : {0} was redirected to {1}", url, myWebResponse.ResponseUri)
End If 

' Release resources of response object.
myWebResponse.Close()

Comentários

O Create método retorna um descendente da WebRequest classe determinada em tempo de execução como a correspondência registrada mais próxima para requestUri.

Por exemplo, quando um URI que começa com http:// ou https:// é passado em requestUri, um HttpWebRequest é retornado por Create. Se um URI começando com ftp:// for passado, o Create método retornará uma FtpWebRequest instância. Se um URI começando com file:// for passado, o Create método retornará uma FileWebRequest instância.

Os tipos de reserva pré-registrados incluem o seguinte:

• http://

• https://

• ftp://

• file://

O .NET inclui suporte para os http://esquemas de URI , https://ftp://, e file:// . Descendentes personalizados WebRequest para lidar com outras solicitações são registrados com o RegisterPrefix método .

O Create método usa o requestUriString parâmetro para criar uma Uri instância que ele passa para o novo WebRequest.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.

Confira também

• Programando protocolos conectáveis

Create(Uri)

Origem:

WebRequest.cs

Cuidado

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.

Inicializa uma nova instância de WebRequest com o esquema de URI especificado.

public:
 static System::Net::WebRequest ^ Create(Uri ^ requestUri);

[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.WebRequest Create (Uri requestUri);

[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : Uri -> System.Net.WebRequest

Public Shared Function Create (requestUri As Uri) As WebRequest

Parâmetros

requestUri

Uri

Um Uri que contém URI do recurso solicitado.

Retornos

WebRequest

Um descendente de WebRequest para o esquema de URI específico.

Atributos

ObsoleteAttribute

Exceções

NotSupportedException

O esquema de solicitação especificado em requestUri não foi registrado.

ArgumentNullException

requestUri é null.

SecurityException

O chamador não tem a permissão WebPermissionAttribute para se conectar ao URI solicitado ou a um URI a que a solicitação é redirecionada.

Exemplos

O exemplo a seguir usa Create para instanciar uma HttpWebRequest instância. Um Uri que representa a URL de destino é usado como o parâmetro do construtor.

// Create a new 'Uri' object with the specified string.
Uri^ myUri = gcnew Uri( "http://www.contoso.com" );
// Create a new request to the above mentioned URL.
WebRequest^ myWebRequest = WebRequest::Create( myUri );
// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

// Create a new 'Uri' object with the specified string.
Uri myUri =new Uri("http://www.contoso.com");
// Create a new request to the above mentioned URL.	
WebRequest myWebRequest= WebRequest.Create(myUri);
// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse myWebResponse= myWebRequest.GetResponse();

' Create a new 'Uri' object with the specified string.
Dim myUri As New Uri("http://www.contoso.com")
' Create a new request to the above mentioned URL.	
Dim myWebRequest As WebRequest = WebRequest.Create(myUri)
'  Assign the response object of 'WebRequest' to a 'WebResponse' variable.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

Comentários

O Create método retorna um descendente da WebRequest classe determinada em tempo de execução como a correspondência registrada mais próxima para requestUri.

Por exemplo, se você criar um WebRequest descendente, Handler1, para lidar com solicitações para http://www.contoso.com/text/ e outro chamado Handler2 para lidar com solicitações para http://www.contoso.com/code/, você poderá usar Create o método para retornar o descendente WebRequest associado a qualquer um dos URI especificados.

Para retornar um descendente da WebRequest classe com base apenas na parte do esquema de um URI, use o CreateDefault método .

Por exemplo, quando um URI que começa com http:// ou https:// é passado em requestUri, um HttpWebRequest é retornado por Create. Se um URI começando com ftp:// for passado, o Create método retornará uma FileWebRequest instância. Se um URI começando com file:// for passado, o Create método retornará uma FileWebRequest instância.

Os tipos de reserva pré-registrados incluem o seguinte:

• http://

• https://

• ftp://

• file://

O .NET inclui suporte para os http://esquemas de URI , https://ftp://, e file:// . Descendentes personalizados WebRequest para lidar com outras solicitações são registrados com o RegisterPrefix método .

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.