WebRequest.Create Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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.