WebRequest.Create Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.Requests.dll

Inizializza un nuovo oggetto WebRequest.

Overload

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

Create(String)

Origine:

WebRequest.cs

Attenzione

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

Inizializza una nuova istanza di WebRequest per lo schema URI specificato.

public:
 static System::Net::WebRequest ^ Create(System::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);

[<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.

Restituisce

WebRequest

Oggetto WebRequest discendente per lo schema URI specificato.

Attributi

ObsoleteAttribute

Eccezioni

NotSupportedException

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

ArgumentNullException

requestUriString è null.

SecurityException

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

UriFormatException

L'URI specificato in requestUriString non è valido.

Nota: in .NET per le app di Windows Store o la libreria di classi portabili, rilevare invece l'eccezione della classe di base, , FormatException.

Esempio

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

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

Commenti

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

Ad esempio, quando un URI a partire da 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 . Se invece viene passato un URI che inizia con file:// , il metodo restituirà un'istanza CreateFileWebRequest .

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

• http://

• https://

• ftp://

• file://

.NET include il supporto per gli http://schemi , https://, ftp://e file:// URI. 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 che passa al nuovo WebRequest.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Vedi anche

• programmazione di protocolli di collegamento

Create(Uri)

Origine:

WebRequest.cs

Attenzione

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

Inizializza una nuova istanza di WebRequest per lo schema URI specificato.

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

[<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.

Restituisce

WebRequest

Oggetto WebRequest discendente per lo schema URI specificato.

Attributi

ObsoleteAttribute

Eccezioni

NotSupportedException

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

ArgumentNullException

requestUri è null.

SecurityException

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

Esempio

Nell'esempio seguente viene Create usata l'istanza di un'istanza HttpWebRequest . 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 = 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()

Commenti

Il Create metodo restituisce un discendente della classe determinata in fase di WebRequest 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 entrambi gli URI specificati.

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

Ad esempio, quando un URI a partire da 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 . Se invece viene passato un URI che inizia con file:// , il metodo restituirà un'istanza CreateFileWebRequest .

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

• http://

• https://

• ftp://

• file://

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

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.