HttpClientConnection Klasse

Definition

Enthält Eigenschaften und Methoden, mit denen ein Paket über das HTTP-Protokoll auf einen Webserver zugreifen kann, um Dateien zu senden oder zu empfangen. Diese Klasse kann nicht vererbt werden.

public ref class HttpClientConnection sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject, Microsoft::SqlServer::Dts::Runtime::IDTSPersist
[System.Serializable]
public sealed class HttpClientConnection : Microsoft.SqlServer.Dts.Runtime.DtsObject, Microsoft.SqlServer.Dts.Runtime.IDTSPersist
[<System.Serializable>]
type HttpClientConnection = class
    inherit DtsObject
    interface IDTSPersist
Public NotInheritable Class HttpClientConnection
Inherits DtsObject
Implements IDTSPersist
Vererbung
HttpClientConnection
Attribute
Implementiert

Hinweise

Der HTTP-Verbindungs-Manager ermöglicht Paketen den Zugriff auf Ressourcen über HTTP, sodass Aufgaben wie das Extrahieren von Daten aus einem Webdienst und das Arbeiten damit möglich sind. Der HTTP-Verbindungs-Manager kapselt die Funktionalität zum Erstellen und Verwalten einer HTTP-Verbindung. Der HTTP-Verbindungs-Manager enthält zusätzlich zu den Eigenschaften, die allen Verbindungs-Managern gemeinsam sind, benutzerdefinierte Eigenschaften. Der HTTP-Verbindungs-Manager stellt der Runtime eine Verbindung mit einem HTTP-Server bereit, der als Quelle fungiert. Wenn Sie einen HTTP-Verbindungs-Manager erstellen, können Sie spezifische Eigenschaften für diese Verbindung angeben und testen, ob die Verbindung aktiv ist. Nachdem die Verbindung erstellt wurde, kann die Verbindung von verschiedenen Aufgaben in der Laufzeit verwendet werden.

Diese Klasse erbt von DtsObject und implementiert IDTSPersist.

Konstruktoren

HttpClientConnection(Object)

Initialisiert eine neue Instanz der HttpClientConnection-Klasse.

Eigenschaften

BypassProxyOnLocal

Ruft einen booleschen Wert ab, der angibt, ob der Proxyserver für die Verwendung von Anmeldeinformationen konfiguriert ist, den Proxyserver umgeht und stattdessen lokale Adressen verwendet, oder legt diesen fest.

Certificate

Ruft ein Bytearray ab, das die tatsächliche X.509-Binärcodierung des Zertifikats darstellt, oder legt es fest.

CertificateIdentifier

Ruft den Bezeichner des X.509-Zertifikats ab oder legt ihn fest.

ChunkSize

Ruft den Wert ab, der die Mindestanzahl von Bytes angibt, die während eines Lese-/Schreibvorgangs vom Server abgerufen oder an ihn gesendet werden, oder legt ihn fest.

ProxyBypassList

Ruft die Adressen ab, die keinen Proxyserver verwenden, oder legt sie fest.

ProxyDomain

Ruft die Domäneneinstellung ab, die zur Anmeldung beim Proxy verwendet wird, oder legt sie fest.

ProxyPassword

Legt das Kennwort fest, das zur Anmeldung beim Proxy verwendet wird. Diese Eigenschaft ist schreibgeschützt.

ProxyURL

Ruft die URL ab, die den Speicherort des Proxys angibt, oder legt sie fest.

ProxyUserName

Ruft den Benutzernamen ab, der zur Anmeldung beim Proxy verwendet wird, oder legt ihn fest.

ServerDomain

Ruft die Domäne ab, die zur Anmeldung beim Server verwendet wird, oder legt sie fest.

ServerPassword

Legt das Kennwort fest, das zur Anmeldung beim Server verwendet wird. Diese Eigenschaft ist lesegeschützt.

ServerURL

Ruft die URL ab, die die Adresse des Servers angibt, oder legt sie fest.

ServerUserName

Ruft den Benutzernamen ab, der zur Anmeldung beim Server verwendet wird, oder legt ihn fest.

Timeout

Ruft die Anzahl der Sekunden ab, nach denen ein Timeout für den HTTP-Vorgang auftritt, oder legt sie fest.

UseProxy

Ruft einen booleschen Wert ab, der angibt, ob die Verbindung einen Proxy verwendet, oder legt diesen fest.

UseProxyCredentials

Ruft einen booleschen Wert ab, der angibt, ob die Verbindung Netzwerkanmeldeinformationen verwendet, oder legt diesen fest.

UseSecureConnection

Ruft einen booleschen Wert ab, der angibt, ob die Verbindung HTTPS oder HTTP ist, oder legt diesen fest.

UseServerCredentials

Ruft einen booleschen Wert ab, der angibt, ob die Verbindung Netzwerkanmeldeinformationen verwendet, oder legt ihn fest.

Methoden

Clone()

Gibt ein neues Verbindungsobjekt zurück, das über genau den gleichen Status verfügt wie das geklonte Objekt.

DownloadData()

Gibt ein Bytearray zurück, das die Daten enthält, die von der in der ServerURL-Eigenschaft angegebenen Ressource heruntergeladen werden.

DownloadFile(String, Boolean)

Lädt Daten von der durch die ServerURL-Eigenschaft angegebenen Ressource in eine lokale Datei herunter.

Equals(Object)

Stellt fest, ob zwei Objektinstanzen gleich sind.

(Geerbt von DtsObject)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

(Geerbt von DtsObject)
GetProxyPassword()

Ruft das Proxykennwort ab.

GetServerPassword()

Ruft das Serverkennwort ab.

LoadFromXML(XmlNode, IDTSEvents)

Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein im XML-Format gespeichertes Paket zu laden, verwenden Sie die LoadPackage(String, IDTSEvents)-Methode.

OpenRead()

Öffnet einen lesbaren Datenstrom, damit Daten von der durch die ServerURL-Eigenschaft angegebenen Ressource heruntergeladen werden.

SaveToXML(XmlDocument, XmlNode, IDTSEvents)

Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein Paket als XML-Datei zu speichern, verwenden Sie die SaveToXml(String, Package, IDTSEvents)-Methode.

ShowCertificateDialog(IntPtr)

Zeigt das Dialogfeld Windows-Zertifikatinformationen an.

Gilt für: