WebRequest.Create Método

Definición

Inicializa un nuevo WebRequest.

Sobrecargas

Nombre Description
Create(String)
Obsoletos.

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

Create(Uri)
Obsoletos.

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

Create(String)

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

Precaución

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

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

Identificador URI que identifica el recurso de Internet.

Devoluciones

Descendiente WebRequest del 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 WebPermissionAttribute permiso para conectarse al URI solicitado o a un URI al que se redirige la solicitud.

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

Ejemplos

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

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 a partir http:// de o https:// en requestUri, devuelve Createun HttpWebRequest valor . Si se pasa un URI que comienza con ftp:// , el Create método devolverá una FtpWebRequest instancia. Si se pasa un URI que comienza con file:// , el Create método devolverá una FileWebRequest instancia.

Los tipos de reserva previamente registrados ya registrados incluyen lo siguiente:

  • 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 al habilitar el seguimiento de red en la aplicación. Para obtener más información, vea Network Tracing in the .NET Framework.

Consulte también

Se aplica a

Create(Uri)

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

Precaución

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

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

que Uri contiene el URI del recurso solicitado.

Devoluciones

Descendiente WebRequest del esquema de URI especificado.

Atributos

Excepciones

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

requestUri es null.

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

Ejemplos

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

// 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 a partir http:// de o https:// en requestUri, devuelve Createun HttpWebRequest valor . Si se pasa un URI que comienza con ftp:// , el Create método devolverá una FileWebRequest instancia. Si se pasa un URI que comienza con file:// , el Create método devolverá una FileWebRequest instancia.

Los tipos de reserva previamente registrados ya registrados incluyen lo siguiente:

  • 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 al habilitar el seguimiento de red en la aplicación. Para obtener más información, vea Network Tracing in the .NET Framework.

Se aplica a