WebRequest.Create Método

Definição

Inicializa um novo WebRequest.

Sobrecargas

Name Description
Create(String)

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

Create(Uri)

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

Create(String)

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

public:
 static System::Net::WebRequest ^ Create(System::String ^ requestUriString);
public static System.Net.WebRequest Create(string requestUriString);
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.

Devoluções

Um WebRequest descendente para o esquema URI específico.

Exceções

O esquema de pedidos especificado requestUriString não foi registado.

requestUriString é null.

O chamador não tem WebPermissionAttribute permissão para se ligar ao URI solicitado ou a um URI para o qual o pedido é redirecionado.

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

Nota: Em .NET para aplicações Windows Store ou a Portable Class Library, apanhe a exceção da classe base, FormatException, em vez disso.

Exemplos

O exemplo seguinte serve Create para instanciar uma HttpWebRequest instância. Uma string que representa a URL de destino é usada como parâmetro construtor.

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()

Observações

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

Por exemplo, quando um URI que começa com http:// ou é passado em requestUri, an HttpWebRequest é devolvido por Createhttps:// . Se um URI que começa por ftp:// for passado em vez disso, o Create método devolverá uma FtpWebRequest instância. Se um URI que começa por file:// for passado em vez disso, o Create método devolverá uma FileWebRequest instância.

Os tipos de reserva pré-registados já registados incluem os seguintes:

  • http://

  • https://

  • ftp://

  • file://

.NET inclui suporte para os esquemas URI http://, https://, ftp:// e file://. Descendentes personalizados WebRequest para lidar com outros pedidos são registados no RegisterPrefix método.

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

Note

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

Ver também

Aplica-se a

Create(Uri)

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

public:
 static System::Net::WebRequest ^ Create(Uri ^ requestUri);
public static System.Net.WebRequest Create(Uri requestUri);
static member Create : Uri -> System.Net.WebRequest
Public Shared Function Create (requestUri As Uri) As WebRequest

Parâmetros

requestUri
Uri

A contendo Uri o URI do recurso solicitado.

Devoluções

Um WebRequest descendente para o esquema URI especificado.

Exceções

O esquema de pedidos especificado em requestUri não está registado.

requestUri é null.

O chamador não tem WebPermissionAttribute permissão para se ligar ao URI solicitado ou a um URI para o qual o pedido é redirecionado.

Exemplos

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

// 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()

Observações

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

Por exemplo, se criares um WebRequest descendente, Handler1, para tratar pedidos para http://www.contoso.com/text/ e outro Handler2 nomeado para tratar pedidos para http://www.contoso.com/code/, podes usar Create o método para devolver o descendente WebRequest associado a qualquer um dos URI especificados.

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

Por exemplo, quando um URI que começa com http:// ou é passado em requestUri, an HttpWebRequest é devolvido por Createhttps:// . Se um URI que começa por ftp:// for passado em vez disso, o Create método devolverá uma FileWebRequest instância. Se um URI que começa por file:// for passado em vez disso, o Create método devolverá uma FileWebRequest instância.

Os tipos de reserva pré-registados já registados incluem os seguintes:

  • http://

  • https://

  • ftp://

  • file://

.NET inclui suporte para os esquemas URI http://, https://, ftp:// e file://. Descendentes personalizados WebRequest para lidar com outros pedidos são registados no RegisterPrefix método.

Note

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

Aplica-se a