WebRequest.Create Metódus

Definíció

Névtér:
System.Net
Szerelvények:
System.dll, System.Net.Requests.dll
Szerelvény:
System.dll
Szerelvény:
netstandard.dll

Új inicializálása WebRequest.

Túlterhelések

Name Description
Create(String)

Inicializál egy új WebRequest példányt a megadott URI-sémához.
Create(Uri)

Inicializál egy új WebRequest példányt a megadott URI-sémához.

Create(String)

Inicializál egy új WebRequest példányt a megadott URI-sémához.

public:
 static System::Net::WebRequest ^ Create(System::String ^ requestUriString);
public static System.Net.WebRequest Create(string requestUriString);
static member Create : string -> System.Net.WebRequest
Public Shared Function Create (requestUriString As String) As WebRequest

Paraméterek

requestUriString
String

Az internetes erőforrást azonosító URI.

Válaszok

WebRequest

Az WebRequest adott URI-séma leszármazottja.

Kivételek

NotSupportedException

A megadott requestUriString kérelemséma nincs regisztrálva.

ArgumentNullException

requestUriString az null.

SecurityException

A hívónak nincs WebPermissionAttribute engedélye csatlakozni a kért URI-hoz vagy egy olyan URI-hoz, amelyhez a kérést átirányítja a rendszer.

UriFormatException

A megadott requestUriString URI nem érvényes URI.

Megjegyzés: Az .NET Windows Áruházbeli alkalmazások vagy a Portable Class Library esetében inkább az alaposztály kivételét FormatException.

Példák

Az alábbi példa egy HttpWebRequest példány példányosítására használjaCreate. Konstruktorparaméterként a cél URL-címet képviselő sztringet használja a rendszer.

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

Megjegyzések

A Create metódus a WebRequest futtatáskor meghatározott osztály leszármazottját adja vissza a legközelebbi regisztrált egyezésként requestUri.

Ha például egy URI-t ad http:// vissza vagy https:// ad át requestUri, HttpWebRequest a visszaadott CreateURI-t a függvény adja vissza. Ha ehelyett egy URI-t ftp:// ad át, a Create metódus egy példányt FtpWebRequest ad vissza. Ha ehelyett egy URI-t file:// ad át, a Create metódus egy példányt FileWebRequest ad vissza.

A már regisztrált előre regisztrált tartaléktípusok a következők:

  • http://

  • https://

  • ftp://

  • file://

.NET támogatja a http://, https://, ftp:// és file:// URI-sémákat. Az egyéb kérések kezelésére vonatkozó egyéni WebRequest leszármazottakat a rendszer regisztrálja a RegisterPrefix metódussal.

A Create metódus a requestUriString paraméterrel hoz létre egy példányt Uri , amelyet az újnak WebRequestad át.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing a .NET-keretrendszerben.

Lásd még

A következőre érvényes:

Create(Uri)

Inicializál egy új WebRequest példányt a megadott URI-sémához.

public:
 static System::Net::WebRequest ^ Create(Uri ^ requestUri);
public static System.Net.WebRequest Create(Uri requestUri);
static member Create : Uri -> System.Net.WebRequest
Public Shared Function Create (requestUri As Uri) As WebRequest

Paraméterek

requestUri
Uri

A Uri kért erőforrás URI-ját tartalmazó.

Válaszok

WebRequest

A WebRequest megadott URI-séma leszármazottja.

Kivételek

NotSupportedException

A megadott requestUri kérelemséma nincs regisztrálva.

ArgumentNullException

requestUri az null.

SecurityException

A hívónak nincs WebPermissionAttribute engedélye csatlakozni a kért URI-hoz vagy egy olyan URI-hoz, amelyhez a kérést átirányítja a rendszer.

Példák

Az alábbi példa egy HttpWebRequest példány példányosítására használjaCreate. Konstruktorparaméterként a cél URL-címet képviselő URI-t használjuk.

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

Megjegyzések

A Create metódus a WebRequest futtatáskor meghatározott osztály leszármazottját adja vissza a legközelebbi regisztrált egyezésként requestUri.

Ha például létrehoz egy leszármazót WebRequest (Handler1) a kérések http://www.contoso.com/text/ kezeléséhez, és egy másik handler2 nevű kezelőt a kérések http://www.contoso.com/code/kezeléséhez, a metódussal Create visszaadhatja a megadott URI-val társított WebRequest leszármazottat.

Ha az osztály leszármazottját csak az WebRequest URI sémarésze alapján szeretné visszaadni, használja a metódust CreateDefault .

Ha például egy URI-t ad http:// vissza vagy https:// ad át requestUri, HttpWebRequest a visszaadott CreateURI-t a függvény adja vissza. Ha ehelyett egy URI-t ftp:// ad át, a Create metódus egy példányt FileWebRequest ad vissza. Ha ehelyett egy URI-t file:// ad át, a Create metódus egy példányt FileWebRequest ad vissza.

A már regisztrált előre regisztrált tartaléktípusok a következők:

  • http://

  • https://

  • ftp://

  • file://

.NET támogatja a http://, https://, ftp:// és file:// URI-sémákat. Az egyéb kérések kezelésére vonatkozó egyéni WebRequest leszármazottakat a rendszer regisztrálja a RegisterPrefix metódussal.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing a .NET-keretrendszerben.

A következőre érvényes: