FtpWebRequest.UsePassive Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt het gedrag van het gegevensoverdrachtproces van een clienttoepassing opgehaald of ingesteld.
public:
property bool UsePassive { bool get(); void set(bool value); };public bool UsePassive { get; set; }member this.UsePassive : bool with get, setPublic Property UsePassive As BooleanWaarde van eigenschap
false als het gegevensoverdrachtproces van de clienttoepassing luistert naar een verbinding op de gegevenspoort; true anders moet de client een verbinding op de gegevenspoort initiëren. De standaardwaarde is true.
Uitzonderingen
Er is een nieuwe waarde opgegeven voor deze eigenschap voor een aanvraag die al wordt uitgevoerd.
Voorbeelden
In het volgende codevoorbeeld worden eigenschapswaarden voor een opgegeven FtpWebRequest object opgehaald en weergegeven.
// DisplayRequestProperties prints a request's properties.
// This method should be called after the request is sent to the server.
private static void DisplayRequestProperties(FtpWebRequest request)
{
Console.WriteLine("User {0} {1}",
request.Credentials.GetCredential(request.RequestUri,"basic").UserName,
request.RequestUri
);
Console.WriteLine("Request: {0} {1}",
request.Method,
request.RequestUri
);
Console.WriteLine("Passive: {0} Keep alive: {1} Binary: {2} Timeout: {3}.",
request.UsePassive,
request.KeepAlive,
request.UseBinary,
request.Timeout == -1 ? "none" : request.Timeout.ToString()
);
IWebProxy proxy = request.Proxy;
if (proxy != null)
{
Console.WriteLine("Proxy: {0}", proxy.GetProxy(request.RequestUri));
}
else
{
Console.WriteLine("Proxy: (none)");
}
Console.WriteLine("ConnectionGroup: {0}",
request.ConnectionGroupName == null ? "none" : request.ConnectionGroupName
);
Console.WriteLine("Encrypted connection: {0}",
request.EnableSsl);
Console.WriteLine("Method: {0}", request.Method);
}
Opmerkingen
Als u de UsePassive eigenschap instelt om true de opdracht "PASV" naar de server te verzenden. Met deze opdracht vraagt u de server om op een gegevenspoort te luisteren en te wachten op een verbinding in plaats van er een te starten na ontvangst van een overdrachtsopdracht.
UsePassiveZie RFC 959: "File Transfer Protocol", Section 3.2: "Establishing Data Connections" en Section 4.1.2: "Transfer Parameter Commands".
Het wijzigen van UsePassive na het aanroepen van de GetRequestStream, BeginGetRequestStream, GetResponse, of BeginGetResponse methode veroorzaakt een InvalidOperationException uitzondering.
Als UsePassive dit is ingesteld trueop, kan de FTP-server de grootte van het bestand niet verzenden en kan de voortgang van het downloaden altijd nul zijn. Als UsePassive deze optie is ingesteld false, kan een firewall een waarschuwing genereren en het downloaden van het bestand blokkeren.