WebRequest.Create Método

Definición

Inicializa un nuevo objeto WebRequest.

Sobrecargas

Create(String)
Obsoletos.

Inicializa una nueva instancia de WebRequest para el esquema URI especificado.

Create(Uri)
Obsoletos.

Inicializa una nueva instancia de WebRequest para el esquema URI especificado.

Create(String)

Source:
WebRequest.cs
Source:
WebRequest.cs
Source:
WebRequest.cs

Precaución

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

Inicializa una nueva instancia de WebRequest para el esquema URI especificado.

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

URI que identifica el recurso de Internet.

Devoluciones

Descendiente WebRequest para un esquema URI específico.

Atributos

Excepciones

El esquema de solicitud especificado en requestUriString no se ha registrado.

requestUriString es null.

El autor de la llamada no tiene permiso WebPermissionAttribute para conectarse al URI solicitado o un URI al que se redirige la solicitud.

El URI especificado en requestUriString no es un URI válido.

Nota: En .NET para aplicaciones de la Tienda Windows o la biblioteca de clases portable, capture la excepción de clase base, FormatException, en su lugar.

Ejemplos

En el ejemplo siguiente se usa Create para crear una instancia de .HttpWebRequest Una cadena que representa la dirección URL de destino se usa como parámetro de constructor.

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 determinada en tiempo de ejecución como la coincidencia registrada más cercana para requestUri.

Por ejemplo, cuando se pasa un URI que comienza con http:// o https:// en requestUri, devuelve un HttpWebRequest valor Create. Si se pasa un URI que empieza por ftp:// , el Create método devolverá una FtpWebRequest instancia. Si se pasa un URI que empieza por file:// , el Create método devolverá una FileWebRequest instancia.

Los tipos de reserva previamente registrados ya están registrados:

  • http://

  • https://

  • ftp://

  • file://

.NET incluye compatibilidad con los http://esquemas de URI , https://, ftp://y file:// . Los descendientes personalizados WebRequest para controlar otras solicitudes se registran con el RegisterPrefix método .

El Create método usa el requestUriString parámetro para crear una Uri instancia que pasa al nuevo WebRequest.

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, vea Seguimiento de red en .NET Framework.

Consulte también

Se aplica a

Create(Uri)

Source:
WebRequest.cs
Source:
WebRequest.cs
Source:
WebRequest.cs

Precaución

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

Inicializa una nueva instancia de WebRequest para el esquema URI especificado.

public:
 static System::Net::WebRequest ^ Create(Uri ^ requestUri);
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);
static member Create : Uri -> System.Net.WebRequest
[<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

Uri que contiene el identificador URI del recurso solicitado.

Devoluciones

Descendiente WebRequest para el esquema URI especificado.

Atributos

Excepciones

El esquema de solicitud especificado en requestUri no está registrado.

requestUri es null.

El autor de la llamada no tiene permiso WebPermissionAttribute para conectarse al URI solicitado o un URI al que se redirige la solicitud.

Ejemplos

En el ejemplo siguiente se usa Create para crear una instancia de .HttpWebRequest Se usa un URI que representa la dirección URL de destino como parámetro de constructor.

// 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 determinada en tiempo de ejecución como la coincidencia registrada más cercana para 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 el método para devolver el descendiente de WebRequest asociado a cualquiera de los URI especificados.

Para devolver un descendiente de la WebRequest clase basándose solo en la parte de esquema de un URI, use el CreateDefault método .

Por ejemplo, cuando se pasa un URI que comienza con http:// o https:// en requestUri, devuelve un HttpWebRequest valor Create. Si se pasa un URI que empieza por ftp:// , el Create método devolverá una FileWebRequest instancia. Si se pasa un URI que empieza por file:// , el Create método devolverá una FileWebRequest instancia.

Los tipos de reserva previamente registrados ya están registrados:

  • http://

  • https://

  • ftp://

  • file://

.NET incluye compatibilidad con los http://esquemas de URI , https://, ftp://y file:// . Los descendientes personalizados WebRequest para controlar otras solicitudes se registran con el RegisterPrefix método .

Nota

Este miembro genera información de seguimiento cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, vea Seguimiento de red en .NET Framework.

Se aplica a