WebRequest.Create Metodo

Definizione

Spazio dei nomi:
System.Net
Assembly:
System.dll, System.Net.Requests.dll
Assembly:
netstandard.dll, System.Net.Requests.dll
Assembly:
System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Inizializza un nuovo WebRequestoggetto .

Overload

Nome Descrizione
Create(String)
Obsoleti.

Inizializza una nuova WebRequest istanza per lo schema URI specificato.
Create(Uri)
Obsoleti.

Inizializza una nuova WebRequest istanza per lo schema URI specificato.

Create(String)

Origine:
WebRequest.cs
Origine:
WebRequest.cs
Origine:
WebRequest.cs
Origine:
WebRequest.cs
Origine:
WebRequest.cs

Attenzione

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

Inizializza una nuova WebRequest istanza per lo schema URI specificato.

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

Parametri

requestUriString
String

URI che identifica la risorsa Internet.

Valori restituiti

WebRequest

Discendente WebRequest per lo schema URI specifico.

Attributi
ObsoleteAttribute

Eccezioni

NotSupportedException

Lo schema di richiesta specificato in requestUriString non è stato registrato.

ArgumentNullException

requestUriString è null.

SecurityException

Il chiamante non dispone WebPermissionAttribute dell'autorizzazione per connettersi all'URI richiesto o a un URI a cui viene reindirizzata la richiesta.

UriFormatException

L'URI specificato in requestUriString non è un URI valido.

Esempio

Nell'esempio seguente viene Create usata per creare un'istanza HttpWebRequest di . Una stringa che rappresenta l'URL di destinazione viene usata come parametro del costruttore.

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()

Commenti

Il Create metodo restituisce un discendente della WebRequest classe determinata in fase di esecuzione come corrispondenza registrata più vicina per requestUri.

Ad esempio, quando un URI che inizia con http:// o https:// viene passato in requestUri, viene HttpWebRequest restituito da Create. Se invece viene passato un URI che inizia con ftp:// , il metodo restituirà un'istanza CreateFtpWebRequest di . Se invece viene passato un URI che inizia con file:// , il metodo restituirà un'istanza CreateFileWebRequest di .

I tipi di riserva preregistrato già registrati includono quanto segue:

  • http://

  • https://

  • ftp://

  • file://

.NET include il supporto per gli http://schemi URI , https://ftp://, e file:// . I discendenti personalizzati WebRequest per gestire altre richieste vengono registrati con il RegisterPrefix metodo .

Il Create metodo usa il parametro per creare un'istanza requestUriStringUri passata al nuovo WebRequestoggetto .

Annotazioni

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Network Tracing in the .NET Framework.

Vedi anche

Si applica a

Create(Uri)

Origine:
WebRequest.cs
Origine:
WebRequest.cs
Origine:
WebRequest.cs
Origine:
WebRequest.cs
Origine:
WebRequest.cs

Attenzione

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

Inizializza una nuova WebRequest istanza per lo schema URI specificato.

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

Parametri

requestUri
Uri

Oggetto Uri contenente l'URI della risorsa richiesta.

Valori restituiti

WebRequest

Discendente WebRequest per lo schema URI specificato.

Attributi
ObsoleteAttribute

Eccezioni

NotSupportedException

Lo schema di richiesta specificato in requestUri non è registrato.

ArgumentNullException

requestUri è null.

SecurityException

Il chiamante non dispone WebPermissionAttribute dell'autorizzazione per connettersi all'URI richiesto o a un URI a cui viene reindirizzata la richiesta.

Esempio

Nell'esempio seguente viene Create usata per creare un'istanza HttpWebRequest di . Un URI che rappresenta l'URL di destinazione viene usato come parametro del costruttore.

// 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()

Commenti

Il Create metodo restituisce un discendente della WebRequest classe determinata in fase di esecuzione come corrispondenza registrata più vicina per requestUri.

Ad esempio, se si crea un WebRequest discendente, Handler1, per gestire le richieste a http://www.contoso.com/text/ e un altro Handler2 denominato per gestire le richieste a http://www.contoso.com/code/, è possibile usare Create il metodo per restituire il discendente WebRequest associato a uno degli URI specificati.

Per restituire un discendente della WebRequest classe in base solo alla parte dello schema di un URI, utilizzare il CreateDefault metodo .

Ad esempio, quando un URI che inizia con http:// o https:// viene passato in requestUri, viene HttpWebRequest restituito da Create. Se invece viene passato un URI che inizia con ftp:// , il metodo restituirà un'istanza CreateFileWebRequest di . Se invece viene passato un URI che inizia con file:// , il metodo restituirà un'istanza CreateFileWebRequest di .

I tipi di riserva preregistrato già registrati includono quanto segue:

  • http://

  • https://

  • ftp://

  • file://

.NET include il supporto per gli http://schemi URI , https://ftp://, e file:// . I discendenti personalizzati WebRequest per gestire altre richieste vengono registrati con il RegisterPrefix metodo .

Annotazioni

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Network Tracing in the .NET Framework.

Si applica a