WebRequest.Create Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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.