FtpWebRequest.ServicePoint Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft das ServicePoint-Objekt ab, das zum Herstellen der Verbindung mit dem FTP-Server verwendet wird.
public:
property System::Net::ServicePoint ^ ServicePoint { System::Net::ServicePoint ^ get(); };
public System.Net.ServicePoint ServicePoint { get; }
member this.ServicePoint : System.Net.ServicePoint
Public ReadOnly Property ServicePoint As ServicePoint
Eigenschaftswert
Ein ServicePoint-Objekt, mit dem das Verbindungsverhalten angepasst werden kann.
Beispiele
Im folgenden Codebeispiel wird der Dienstpunkt aus einer Anforderung abgerufen und die maximale Anzahl von Verbindungen auf eine festgelegt.
static bool ListFilesOnServer( Uri^ serverUri )
{
// The serverUri should start with the ftp:// scheme.
if ( serverUri->Scheme != Uri::UriSchemeFtp )
{
return false;
}
// Get the object used to communicate with the server.
FtpWebRequest^ request = dynamic_cast<FtpWebRequest^>(WebRequest::Create( serverUri ));
request->Method = WebRequestMethods::Ftp::ListDirectory;
// Get the ServicePoint object used for this request, and limit it to one connection.
// In a real-world application you might use the default number of connections (2),
// or select a value that works best for your application.
ServicePoint^ sp = request->ServicePoint;
Console::WriteLine( "ServicePoint connections = {0}.", sp->ConnectionLimit );
sp->ConnectionLimit = 1;
FtpWebResponse^ response = dynamic_cast<FtpWebResponse^>(request->GetResponse());
// The following streams are used to read the data returned from the server.
Stream^ responseStream = nullptr;
StreamReader^ readStream = nullptr;
try
{
responseStream = response->GetResponseStream();
readStream = gcnew StreamReader( responseStream,System::Text::Encoding::UTF8 );
if ( readStream != nullptr )
{
// Display the data received from the server.
Console::WriteLine( readStream->ReadToEnd() );
}
Console::WriteLine( "List status: {0}", response->StatusDescription );
}
finally
{
if ( readStream != nullptr )
{
readStream->Close();
}
if ( response != nullptr )
{
response->Close();
}
}
return true;
}
public static bool ListFilesOnServer(Uri serverUri)
{
// The serverUri should start with the ftp:// scheme.
if (serverUri.Scheme != Uri.UriSchemeFtp)
{
return false;
}
// Get the object used to communicate with the server.
FtpWebRequest request = (FtpWebRequest)WebRequest.Create(serverUri);
request.Method = WebRequestMethods.Ftp.ListDirectory;
// Get the ServicePoint object used for this request, and limit it to one connection.
// In a real-world application you might use the default number of connections (2),
// or select a value that works best for your application.
ServicePoint sp = request.ServicePoint;
Console.WriteLine("ServicePoint connections = {0}.", sp.ConnectionLimit);
sp.ConnectionLimit = 1;
FtpWebResponse response = (FtpWebResponse) request.GetResponse();
// The following streams are used to read the data returned from the server.
Stream responseStream = null;
StreamReader readStream = null;
try
{
responseStream = response.GetResponseStream();
readStream = new StreamReader(responseStream, System.Text.Encoding.UTF8);
if (readStream != null)
{
// Display the data received from the server.
Console.WriteLine(readStream.ReadToEnd());
}
Console.WriteLine("List status: {0}",response.StatusDescription);
}
finally
{
if (readStream != null)
{
readStream.Close();
}
if (response != null)
{
response.Close();
}
}
return true;
}
Hinweise
Wenn kein ServicePoint Objekt vorhanden ist, wird eines für den FTP-Server erstellt. Um die maximale Anzahl von Verbindungen festzulegen, die für einen FTP-Server geöffnet werden können, legen Sie die ConnectionLimit Eigenschaft der ServicePoint von dieser Eigenschaft zurückgegebenen Instanz fest.