WebRequest.RequestUri-Eigenschaft

Artikel
08/20/2007

Ruft beim Überschreiben in einer untergeordneten Klasse den mit der Anforderung verknüpften URI der Internetressource ab.

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
Public Overridable ReadOnly Property RequestUri As Uri
'Usage
Dim instance As WebRequest
Dim value As Uri

value = instance.RequestUri

public virtual Uri RequestUri { get; }

public:
virtual property Uri^ RequestUri {
    Uri^ get ();
}

/** @property */
public Uri get_RequestUri ()

public function get RequestUri () : Uri

Eigenschaftenwert

Ein Uri, der die der Anforderung zugeordnete Ressource darstellt.

Ausnahmen

Ausnahmetyp	Bedingung
NotImplementedException	Es wurde versucht, die Eigenschaft abzurufen oder festzulegen, obwohl die Eigenschaft in einer abgeleiteten Klasse nicht überschrieben wurde.

Hinweise

Die RequestUri-Eigenschaft enthält beim Überschreiben in einer abgeleiteten Klasse die Uri-Instanz, die von der Create-Methode zum Erstellen der Anforderung verwendet wird.

Hinweis

Die WebRequest-Klasse ist eine abstract Klasse. Das tatsächliche Verhalten von WebRequest-Instanzen zur Laufzeit wird von der abgeleiteten Klasse bestimmt, die von der System.Net.WebRequest.Create-Methode zurückgegeben wird. Weitere Informationen über Standardwerte und Ausnahmen finden Sie in der Dokumentation zu den abgeleiteten Klassen, z. B. HttpWebRequest und FileWebRequest.

Hinweise für Erben RequestUri muss die ursprüngliche, an die Create-Methode übergebene Uri-Instanz enthalten. Wenn das Protokoll die Anforderung zum Bearbeiten an einen unterschiedlichen URI umleiten kann, muss von der abgeleiteten Klasse eine Eigenschaft mit dem URI bereitgestellt werden, der die Anforderung tatsächlich bearbeitet.

Beispiel

Im folgenden Beispiel wird die RequestUri-Eigenschaft überprüft, um die ursprünglich angeforderte Site zu bestimmen.

' Create a new WebRequest Object to the mentioned URL.
Dim myWebRequest As WebRequest = WebRequest.Create("http://www.example.com")
Console.WriteLine(ControlChars.Cr + "The Uri that responded for the Request is   {0}", myWebRequest.RequestUri)
' Assign the response object of 'WebRequest' to a 'WebResponse' variable.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()
' Print the HTML contents of the page to the console. 
Dim streamResponse As Stream = myWebResponse.GetResponseStream()
Dim streamRead As New StreamReader(streamResponse)
Dim readBuff(256) As [Char]
Dim count As Integer = streamRead.Read(readBuff, 0, 256)
Console.WriteLine(ControlChars.Cr + "The Uri that responded for the Request is   {0}", myWebRequest.RequestUri)

// Create a new WebRequest Object to the mentioned URL.
WebRequest myWebRequest=WebRequest.Create("http://www.example.com");
Console.WriteLine("\nThe Uri that responded for the Request is   {0}",myWebRequest.RequestUri);
// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse myWebResponse=myWebRequest.GetResponse();
// Print the HTML contents of the page to the console. 
Stream streamResponse=myWebResponse.GetResponseStream();
StreamReader streamRead = new StreamReader( streamResponse );
Char[] readBuff = new Char[256];
int count = streamRead.Read( readBuff, 0, 256 );    
Console.WriteLine("\nThe Uri that responded for the Request is '{0}'",myWebRequest.RequestUri);

// Create a new WebRequest object to the mentioned URL.
WebRequest^ myWebRequest = WebRequest::Create( "http://www.example.com" );
Console::WriteLine( "\nThe Uri that responded for the Request is {0}", myWebRequest->RequestUri );
// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse^ myWebResponse = myWebRequest->GetResponse();
// Print the HTML contents of the page to the console.
Stream^ streamResponse = myWebResponse->GetResponseStream();
StreamReader^ streamRead = gcnew StreamReader( streamResponse );
array<Char>^ readBuff = gcnew array<Char>(256);
int count = streamRead->Read( readBuff, 0, 256 );
Console::WriteLine( "\nThe Uri that responded for the Request is ' {0}'", myWebRequest->RequestUri );

// Create a new WebRequest Object to the mentioned URL.
WebRequest myWebRequest = WebRequest.Create("http://www.example.com");
Console.WriteLine("\nThe Uri that responded for the Request is   {0}",
    myWebRequest.get_RequestUri());
// Assign the response object of 'WebRequest' to a 'WebResponse'
// variable.
WebResponse myWebResponse = myWebRequest.GetResponse();
// Print the HTML contents of the page to the console. 
Stream streamResponse = myWebResponse.GetResponseStream();
StreamReader streamRead = new StreamReader(streamResponse);
char readBuff[] = new char[256];
int count = streamRead.Read(readBuff, 0, 256);
Console.WriteLine("\nThe Uri that responded for the Request" 
    + " is '{0}'", myWebRequest.get_RequestUri());

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

WebRequest-Klasse
WebRequest-Member
System.Net-Namespace
HttpWebRequest.RequestUri-Eigenschaft
HttpWebRequest.Address-Eigenschaft

Freigeben über