WebRequest.CreatorInstance Eigenschaft

Definition

Namespace:

System.Net

Assembly:

System.dll

Achtung

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Ruft beim Überschreiben in einer Nachfolgerklasse das von der IWebRequestCreate-Klasse abgeleitete Factoryobjekt ab. Mit dieser Klasse wird die WebRequest erstellt, die instanziiert wird, um die Anforderung an den angegebenen URI zu stellen.

public:
 virtual property System::Net::IWebRequestCreate ^ CreatorInstance { System::Net::IWebRequestCreate ^ get(); };

[System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)]
public virtual System.Net.IWebRequestCreate CreatorInstance { get; }

[<System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)>]
member this.CreatorInstance : System.Net.IWebRequestCreate

Public Overridable ReadOnly Property CreatorInstance As IWebRequestCreate

Eigenschaftswert

IWebRequestCreate

Der abgeleitete WebRequest-Typ, der von der Create(Uri)-Methode zurückgegeben wird.

Attribute

ObsoleteAttribute

Hinweise

Mit dieser Eigenschaft kann eine Anwendung bestimmen, welches abgeleitete IWebRequestCreate Factoryobjekt zum Erstellen der Anforderung verwendet wurde. Dieses Objekt kann System.Net.Browser.WebRequestCreator.BrowserHttp oder System.Net.Browser.WebRequestCreator.ClientHttp sein, es kann aber auch eine benutzerdefinierte Instanz sein, die von IWebRequestCreateabgeleitet wird. Dadurch kann eine Anwendung bestimmen, ob der Browser, der Silverlight-Client oder ein benutzerdefiniertes Objekt HTTP-Anforderungen und -Antworten für die WebRequest Instanz verarbeitet. Mit RegisterPrefix der -Methode kann eine Anwendung konfigurieren, welcher abgeleitete WebRequest Typ instanziiert wird, wenn eine Anforderung an einen bestimmten URI gestellt wird. WebRequest Ersteller werden in der Regel registriert, um ein bestimmtes Protokoll zu behandeln, z. B. HTTP oder HTTPS, können jedoch registriert werden, um eine Anforderung an einen bestimmten Server oder Pfad auf einem Server zu verarbeiten. Dies ist nützlich, wenn mehrere abgeleitete WebRequest Typen Anforderungen für dasselbe Protokoll verarbeiten können. Die Microsoft Silverlight 3 und höher unterstützt mehrere HTTP-Handler mit unterschiedlichen Funktionen. Für einen Webdienst, der die Representational State Transfer (REST) verwendet, kann beispielsweise der System.Net.Browser.WebRequestCreator.ClientHttpHttp-Handler erforderlich sein, während ein SOAP-Webdienst möglicherweise den Standardhandler System.Net.Browser.WebRequestCreator.BrowserHttp verwenden kann.