Freigeben über


WebRequest.RegisterPrefix-Methode

Registriert einen WebRequest-Nachkommen für den angegebenen URI.

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

Syntax

'Declaration
Public Shared Function RegisterPrefix ( _
    prefix As String, _
    creator As IWebRequestCreate _
) As Boolean
'Usage
Dim prefix As String
Dim creator As IWebRequestCreate
Dim returnValue As Boolean

returnValue = WebRequest.RegisterPrefix(prefix, creator)
public static bool RegisterPrefix (
    string prefix,
    IWebRequestCreate creator
)
public:
static bool RegisterPrefix (
    String^ prefix, 
    IWebRequestCreate^ creator
)
public static boolean RegisterPrefix (
    String prefix, 
    IWebRequestCreate creator
)
public static function RegisterPrefix (
    prefix : String, 
    creator : IWebRequestCreate
) : boolean

Parameter

  • prefix
    Der vollständige URI oder das URI-Präfix, der bzw. das den WebRequest-Nachkommen bearbeitet.
  • creator
    Die Erstellungsmethode, die die WebRequest zum Erstellen des WebRequest-Nachkommens aufruft.

Rückgabewert

true, wenn die Registrierung erfolgreich ist, andernfalls false.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

prefix ist NULL (Nothing in Visual Basic)

– oder –

creator ist NULL (Nothing in Visual Basic).

Hinweise

Die RegisterPrefix-Methode registriert WebRequest-Nachkommen zur Bearbeitung von Anforderungen. WebRequest-Nachkommen werden i. d. R. zum Behandeln eines bestimmten Protokolls, z. B. HTTP oder FTP, registriert, können jedoch auch zum Behandeln einer Anforderung eines bestimmten Servers bzw. eines Pfades zu einem Server registriert werden.

Die Verdoppelung von Präfixen ist nicht zulässig. RegisterPrefix gibt beim versuchten Registrieren eines doppelten Präfixes false zurück.

Hinweis

Die HttpWebRequest-Klasse wird standardmäßig zur Bearbeitung von Anforderungen für HTTP- und HTTPS-Schemas registriert. Alle Versuche, einen davon abweichenden WebRequest-Nachkommen für diese Schemas zu registrieren, schlagen fehl.

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