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

Definición

Inicializa un nuevo objeto WebRequest. Initializes a new WebRequest.

Sobrecargas

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

Inicializa una nueva instancia de WebRequest para el esquema URI especificado. Initializes a new WebRequest instance for the specified URI scheme.

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

Inicializa una nueva instancia de WebRequest para el esquema URI especificado. Initializes a new WebRequest instance for the specified URI scheme.

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

Inicializa una nueva instancia de WebRequest para el esquema 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

URI que identifica el recurso de Internet. The URI that identifies the Internet resource.

Devoluciones

Descendiente WebRequest para un esquema URI específico. A WebRequest descendant for the specific URI scheme.

Excepciones

El esquema de solicitud especificado en requestUriString no se ha registrado. The request scheme specified in requestUriString has not been registered.

requestUriString es null. requestUriString is null.

El autor de la llamada no tiene permiso para conectarse al URI solicitado o un URI al que se redirige la solicitud. The caller does not have permission to connect to the requested URI or a URI that the request is redirected to.

En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, capture en su lugar la excepción de clase base, FormatException. In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

El URI especificado en requestUriString no es un URI válido. The URI specified in requestUriString is not a valid URI.

Ejemplos

En el ejemplo siguiente se usa Create para crear instancias de un HttpWebRequest instancia.The following example uses Create to instantiate an HttpWebRequest instance. Una cadena que representa la dirección URL de destino se usa como parámetro de constructor.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()

Comentarios

El Create método devuelve un descendiente de la WebRequest clase determinado en tiempo de ejecución como la coincidencia más próxima registrada para requestUri.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Por ejemplo, cuando un URI que comience por http:// o https:// se pasa en requestUri, un HttpWebRequest devuelto por Create.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. Si un URI que comience por ftp:// se pasa en su lugar, el Create método devolverá un FtpWebRequest instancia.If a URI beginning with ftp:// is passed instead, the Create method will return a FtpWebRequest instance. Si un URI que comience por file:// se pasa en su lugar, el Create método devolverá un FileWebRequest instancia.If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

Los tipos de reserva registrados previamente ya registrados incluyen lo siguiente:The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

.NET incluye compatibilidad con la http://, https://, ftp://, y file:// esquemas de URI..NET includes support for the http://, https://, ftp://, and file:// URI schemes. Custom WebRequest descendientes para controlar otras solicitudes se registran con el RegisterPrefix método.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.

El Create método usa la requestUriString parámetro para crear un Uri que pasa a la nueva instancia de WebRequest.The Create method uses the requestUriString parameter to create a Uri instance that it passes to the new WebRequest.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación.This member outputs trace information when you enable network tracing in your application. Para obtener más información, consulte [ <topic://conUsingNetworkTracing >].For more information, see [<topic://conUsingNetworkTracing>].

Consultar también

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

Inicializa una nueva instancia de WebRequest para el esquema 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

Uri que contiene el identificador URI del recurso solicitado. A Uri containing the URI of the requested resource.

Devoluciones

Descendiente WebRequest para el esquema URI especificado. A WebRequest descendant for the specified URI scheme.

Excepciones

El esquema de solicitud especificado en requestUri no está registrado. The request scheme specified in requestUri is not registered.

El autor de la llamada no tiene permiso para conectarse al URI solicitado o un URI al que se redirige la solicitud. The caller does not have permission to connect to the requested URI or a URI that the request is redirected to.

Ejemplos

En el ejemplo siguiente se usa Create para crear instancias de un HttpWebRequest instancia.The following example uses Create to instantiate an HttpWebRequest instance. Un Uri que representa la dirección URL de destino se usa como parámetro de constructor.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()

Comentarios

El Create método devuelve un descendiente de la WebRequest clase determinado en tiempo de ejecución como la coincidencia más próxima registrada para requestUri.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Por ejemplo, si crea un WebRequest descendiente, Handler1, para controlar las solicitudes a http://www.contoso.com/text/ y otro denominado Handler2 para controlar las solicitudes a http://www.contoso.com/code/, puede usar Create método para devolver el descendiente de WebRequest asociado 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 devolver un descendiente de la WebRequest clase según sólo la parte del esquema de un URI, use el 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 ejemplo, cuando un URI que comience por http:// o https:// se pasa en requestUri, un HttpWebRequest devuelto por Create.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. Si un URI que comience por ftp:// se pasa en su lugar, el Create método devolverá un FileWebRequest instancia.If a URI beginning with ftp:// is passed instead, the Create method will return a FileWebRequest instance. Si un URI que comience por file:// se pasa en su lugar, el Create método devolverá un FileWebRequest instancia.If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

Los tipos de reserva registrados previamente ya registrados incluyen lo siguiente:The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

.NET incluye compatibilidad con la http://, https://, ftp://, y file:// esquemas de URI..NET includes support for the http://, https://, ftp://, and file:// URI schemes. Custom WebRequest descendientes para controlar otras solicitudes se registran con el RegisterPrefix método.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación.This member outputs trace information when you enable network tracing in your application. Para obtener más información, consulte [ <topic://conUsingNetworkTracing >].For more information, see [<topic://conUsingNetworkTracing>].

Se aplica a