WebRequest.Create WebRequest.Create WebRequest.Create WebRequest.Create Method

Definição

Inicializa um novo WebRequest.Initializes a new WebRequest.

Sobrecargas

Create(String) Create(String) Create(String) Create(String)

Inicializa uma nova instância de WebRequest com o esquema de URI especificado.Initializes a new WebRequest instance for the specified URI scheme.

Create(Uri) Create(Uri) Create(Uri) Create(Uri)

Inicializa uma nova instância de WebRequest com o esquema de URI especificado.Initializes a new WebRequest instance for the specified URI scheme.

Create(String) Create(String) Create(String) Create(String)

Inicializa uma nova instância de WebRequest com o esquema de URI especificado.Initializes a new WebRequest instance for the specified URI scheme.

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 String String String

O URI que identifica o recurso da Internet.The URI that identifies the Internet resource.

Retornos

Um descendente de WebRequest para o esquema de URI específico.A WebRequest descendant for the specific URI scheme.

Exceções

O esquema de solicitação especificado em requestUriString não foi registrado.The request scheme specified in requestUriString has not been registered.

requestUriString é null.requestUriString is null.

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.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Em vez disso, no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

O URI especificado em requestUriString não é um URI válido.The URI specified in requestUriString is not a valid URI.

Exemplos

O exemplo a seguir usa Create para instanciar um HttpWebRequest instância.The following example uses Create to instantiate an HttpWebRequest instance. Uma cadeia de caracteres que representa a URL de destino é usada como o parâmetro de construtor.A string representing the target URL is used as the constructor parameter.

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 do WebRequest classe determinada em tempo de execução como a correspondência mais próxima registrado para requestUri.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Por exemplo, quando um URI começando com http:// ou https:// é passado requestUri, uma HttpWebRequest retornado pelo Create.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. Se um URI começando com ftp:// é passado em vez disso, o Create método será retornado um FtpWebRequest instância.If a URI beginning with ftp:// is passed instead, the Create method will return a FtpWebRequest instance. Se um URI começando com file:// é passado em vez disso, o Create método será retornado um FileWebRequest instância.If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

Os tipos de reserva previamente registrado já registrados incluem o seguinte:The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

O .NET inclui suporte para o http://, https://, ftp://, e file:// esquemas de URI..NET includes support for the http://, https://, ftp://, and file:// URI schemes. Custom WebRequest descendentes para lidar com outras solicitações são registradas com o RegisterPrefix método.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.

O Create usa o requestUriString parâmetro para criar um Uri instância que ele passa para o novo WebRequest.The Create method uses the requestUriString parameter to create a Uri instance that it passes to the new WebRequest.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede no .NET Framework.For more information, see Network Tracing in the .NET Framework.

Veja também

Create(Uri) Create(Uri) Create(Uri) Create(Uri)

Inicializa uma nova instância de WebRequest com o esquema de URI especificado.Initializes a new WebRequest instance for the specified URI scheme.

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 Uri Uri Uri

Um Uri que contém URI do recurso solicitado.A Uri containing the URI of the requested resource.

Retornos

Um descendente de WebRequest para o esquema de URI específico.A WebRequest descendant for the specified URI scheme.

Exceções

O esquema de solicitação especificado em requestUri não foi registrado.The request scheme specified in requestUri is not registered.

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.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Exemplos

O exemplo a seguir usa Create para instanciar um HttpWebRequest instância.The following example uses Create to instantiate an HttpWebRequest instance. Um Uri que representa a URL de destino é usado como o parâmetro de construtor.A Uri representing the target URL is used as the constructor parameter.

// 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 do WebRequest classe determinada em tempo de execução como a correspondência mais próxima registrado para requestUri.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Por exemplo, se você criar uma WebRequest descendente, Handler1, para manipular solicitações para http://www.contoso.com/text/ e outro denominado Handler2 para manipular solicitações e http://www.contoso.com/code/, você pode usar Create método para retornar o descendente de WebRequest associado com qualquer uma URI especificado.For example, if you create a WebRequest descendant, Handler1, to handle requests to http://www.contoso.com/text/ and another named Handler2 to handle requests to http://www.contoso.com/code/, you can use Create method to return the WebRequest descendant associated with either specified URI.

Para retornar um descendente do WebRequest classe baseia-se somente a parte do esquema de um URI, use o CreateDefault método.To return a descendant of the WebRequest class based on only the scheme portion of a URI, use the CreateDefault method.

Por exemplo, quando um URI começando com http:// ou https:// é passado requestUri, uma HttpWebRequest retornado pelo Create.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. Se um URI começando com ftp:// é passado em vez disso, o Create método será retornado um FileWebRequest instância.If a URI beginning with ftp:// is passed instead, the Create method will return a FileWebRequest instance. Se um URI começando com file:// é passado em vez disso, o Create método será retornado um FileWebRequest instância.If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

Os tipos de reserva previamente registrado já registrados incluem o seguinte:The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

O .NET inclui suporte para o http://, https://, ftp://, e file:// esquemas de URI..NET includes support for the http://, https://, ftp://, and file:// URI schemes. Custom WebRequest descendentes para lidar com outras solicitações são registradas com o RegisterPrefix método.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede no .NET Framework.For more information, see Network Tracing in the .NET Framework.

Aplica-se a