WebRequest.RequestUri Propriedade

Definição

Namespace:

System.Net

Assemblies:

netstandard.dll, System.Net.Requests.dll

Origem:

WebRequest.cs

Quando substituído em uma classe descendente, obtém o URI do recurso de Internet associado à solicitação.

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

public virtual Uri RequestUri { get; }

member this.RequestUri : Uri

Public Overridable ReadOnly Property RequestUri As Uri

Valor da propriedade

Uri

Um Uri que representa o recurso associado à solicitação.

Exceções

NotImplementedException

Qualquer tentativa é feita para obter ou definir a propriedade, quando a propriedade não é substituída em uma classe descendente.

Exemplos

O exemplo a seguir verifica a RequestUri propriedade para determinar o site solicitado originalmente.

      // Create a new WebRequest Object to the mentioned URL.
      WebRequest myWebRequest=WebRequest.Create("http://www.contoso.com");
      Console.WriteLine("\nThe Uri that was requested is {0}",myWebRequest.RequestUri);
      // Assign the response object of 'WebRequest' to a 'WebResponse' variable.
      WebResponse myWebResponse=myWebRequest.GetResponse();
      // Get the stream containing content returned by the server.
      Stream streamResponse=myWebResponse.GetResponseStream();
      Console.WriteLine("\nThe Uri that responded to the WebRequest is '{0}'",myWebResponse.ResponseUri);
StreamReader reader = new StreamReader (streamResponse);
      // Read the content.
string responseFromServer = reader.ReadToEnd ();
// Display the content.
Console.WriteLine("\nThe HTML Contents received:");
Console.WriteLine (responseFromServer);
// Cleanup the streams and the response.
reader.Close ();
streamResponse.Close ();
myWebResponse.Close ();

' Create a new WebRequest Object to the mentioned URL.
Dim myWebRequest As WebRequest = WebRequest.Create("http://www.contoso.com")
Console.WriteLine(ControlChars.Cr + ControlChars.Lf +"The Uri that was requested is {0}", myWebRequest.RequestUri)
' Assign the response object of 'WebRequest' to a 'WebResponse' variable.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()
      ' Get the stream containing content returned by the server.
Dim streamResponse As Stream = myWebResponse.GetResponseStream()
Console.WriteLine(ControlChars.Cr + ControlChars.Lf + "The Uri that responded to the request is {0}", myWebResponse.ResponseUri)
' Print the HTML contents of the page to the console. 
Dim reader As New StreamReader(streamResponse)
      ' Read the content.
      Dim responseFRomServer As String = reader.ReadToEnd()
' Display the content.
Console.WriteLine(ControlChars.Cr + ControlChars.Lf +"The HTML Contents received:")
Console.WriteLine (responseFromServer)
' Cleanup the streams and the response.
reader.Close ()
streamResponse.Close ()
myWebResponse.Close ()

Comentários

Cuidado

WebRequest, HttpWebRequeste ServicePointWebClient são obsoletos e você não deve usá-los para um novo desenvolvimento. Use HttpClient em seu lugar.

Quando substituída em uma classe descendente, a RequestUri propriedade contém a instância que Create o Uri método usa para criar a solicitação.

Nota

A WebRequest classe é uma abstract classe. O comportamento real das instâncias em tempo de WebRequest execução é determinado pela classe descendente retornada pelo WebRequest.Create método. Para obter mais informações sobre valores e exceções padrão, consulte a documentação das classes descendentes, como HttpWebRequest e FileWebRequest.

Notas aos Implementadores

RequestUri deve conter a instância original Uri passada para o Create(Uri) método. Se o protocolo for capaz de redirecionar a solicitação para um URI diferente para atender à solicitação, o descendente deverá fornecer uma propriedade para conter o URI que realmente atende à solicitação

Confira também

• RequestUri
• Address