FtpWebRequest.Method 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 haalt u de opdracht op of stelt u deze in om naar de FTP-server te verzenden.
public:
virtual property System::String ^ Method { System::String ^ get(); void set(System::String ^ value); };public override string Method { get; set; }member this.Method : string with get, setPublic Overrides Property Method As StringWaarde van eigenschap
Een String waarde die de FTP-opdracht bevat die naar de server moet worden verzonden. De standaardwaarde is DownloadFile.
Uitzonderingen
Er is een nieuwe waarde opgegeven voor deze eigenschap voor een aanvraag die al wordt uitgevoerd.
De methode is ongeldig.
– of –
De methode wordt niet ondersteund.
– of –
Er zijn meerdere methoden opgegeven.
Voorbeelden
In het volgende codevoorbeeld wordt deze eigenschap ingesteld op DeleteFile.
public static bool DeleteFileOnServer(Uri serverUri)
{
// The serverUri parameter should use the ftp:// scheme.
// It contains the name of the server file that is to be deleted.
// Example: ftp://contoso.com/someFile.txt.
//
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.DeleteFile;
FtpWebResponse response = (FtpWebResponse) request.GetResponse();
Console.WriteLine("Delete status: {0}",response.StatusDescription);
response.Close();
return true;
}
Opmerkingen
De Method eigenschap bepaalt welke opdracht naar de server wordt verzonden. U stelt de Method tekenreeksen in die zijn gedefinieerd in de leden van het openbare veld van de WebRequestMethods.Ftp klasse. De tekenreeksen die in de WebRequestMethods.Ftp klasse zijn gedefinieerd, zijn de enige ondersteunde opties voor de Method eigenschap. Als u de Method eigenschap instelt op een andere waarde, resulteert dit in een ArgumentException uitzondering.
Wanneer u dit instelt MethodUploadFile, moet u dit doen voordat u de GetRequestStream methode aanroept. Als u deze leden niet in de juiste volgorde aanroept, wordt er een ProtocolViolationException uitzondering veroorzaakt wanneer u de aanvraagstroom probeert te verkrijgen.
De referenties die voor het FtpWebRequest object zijn opgegeven, moeten gemachtigd zijn om de opgegeven methode uit te voeren. Als dat niet het probleem is, mislukt de FTP-opdracht.
Als u het slagen of mislukken van een opdracht wilt bepalen, controleert u de StatusCode en StatusDescription eigenschappen.