FtpWebResponse クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
要求に対するファイル転送プロトコル (FTP: File Transfer Protocol) サーバーの応答をカプセル化します。
public ref class FtpWebResponse : System::Net::WebResponse, IDisposable
public ref class FtpWebResponse : System::Net::WebResponse
public class FtpWebResponse : System.Net.WebResponse, IDisposable
public class FtpWebResponse : System.Net.WebResponse
type FtpWebResponse = class
inherit WebResponse
interface IDisposable
Public Class FtpWebResponse
Inherits WebResponse
Implements IDisposable
Public Class FtpWebResponse
Inherits WebResponse
- 継承
- 実装
例
次のコード例では、FTP サーバー上のファイルを削除する要求を送信し、要求に対するサーバーの応答からステータス メッセージを表示します。 その他の例については、 クラスと FtpWebRequest クラスのメンバーに関するページをWebRequestMethods.Ftp参照してください。
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 = dynamic_cast<FtpWebRequest^>(WebRequest::Create( serverUri ));
request->Method = WebRequestMethods::Ftp::DeleteFile;
FtpWebResponse^ response = dynamic_cast<FtpWebResponse^>(request->GetResponse());
Console::WriteLine( "Delete status: {0}", response->StatusDescription );
response->Close();
return true;
}
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;
}
注釈
の FtpWebResponse インスタンスは、 メソッドを呼び出すことによって取得されます GetResponse 。 返されるオブジェクトは、 にキャストする FtpWebResponse必要があります。 アプリケーションで オブジェクトが不要になったら、 メソッドをFtpWebResponseClose呼び出して、 によって保持されているリソースをFtpWebResponse解放します。
プロパティには StatusCode サーバーから返される状態コードが含まれており StatusDescription 、 プロパティは状態コードと状態を説明するメッセージを返します。 これらのプロパティによって返される値は、サーバーからメッセージが返されると変更されます。
要求によって返されるデータ (要求に対 ListDirectory して返されるファイル名の一覧など) は、 メソッドによって GetResponseStream 返されるストリームで使用できます。 ストリーム データの長さは、 プロパティから ContentLength 取得できます。
プロパティ
BannerMessage |
ログオン前に接続が確立された場合に、FTP サーバーが送信するメッセージを取得します。 |
ContentLength |
FTP サーバーから受信したデータの長さを取得します。 |
ContentType |
常に NotImplementedException をスローします。 |
ContentType |
派生クラスでオーバーライドされると、受信しているデータのコンテンツ タイプを取得または設定します。 (継承元 WebResponse) |
ExitMessage |
FTP セッションの終了時にサーバーが送信するメッセージを取得します。 |
Headers |
空の WebHeaderCollection オブジェクトを取得します。 |
IsFromCache |
この応答がキャッシュから取得されたかどうかを示す Boolean 値を取得します。 (継承元 WebResponse) |
IsMutuallyAuthenticated |
相互認証が行われたかどうかを示す Boolean 値を取得します。 (継承元 WebResponse) |
LastModified |
FTP サーバー上のファイルが最後に更新された日時を取得します。 |
ResponseUri |
要求に対する応答を送信する URI を取得します。 |
StatusCode |
FTP サーバーから送信された最新のステータス コードを取得します。 |
StatusDescription |
FTP サーバーから送信されたステータス コードを示すテキストを取得します。 |
SupportsHeaders |
Headers プロパティが FtpWebResponse インスタンスによってサポートされているかどうかを示す値を取得します。 |
SupportsHeaders |
ヘッダーがサポートされているかどうかを示す値を取得します。 (継承元 WebResponse) |
WelcomeMessage |
認証の完了時に FTP サーバーが送信するメッセージを取得します。 |
メソッド
Close() |
応答によって保持されているリソースを解放します。 |
CreateObjRef(Type) |
リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject) |
Dispose() |
WebResponse オブジェクトによって使用されているアンマネージ リソースを解放します。 (継承元 WebResponse) |
Dispose(Boolean) |
WebResponse オブジェクトによって使用されているアンマネージド リソースを解放します。オプションとして、マネージド リソースを破棄することもできます。 (継承元 WebResponse) |
Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
GetLifetimeService() |
古い.
対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
GetObjectData(SerializationInfo, StreamingContext) |
古い.
SerializationInfo に、ターゲット オブジェクトをシリアル化するために必要なデータを設定します。 (継承元 WebResponse) |
GetResponseStream() |
FTP サーバーから送信された応答データを格納しているストリームを取得します。 |
GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
InitializeLifetimeService() |
古い.
このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
MemberwiseClone(Boolean) |
現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject) |
ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
明示的なインターフェイスの実装
IDisposable.Dispose() |
派生クラスでオーバーライドされた場合、WebResponse で使用したすべてのリソースを解放します。 (継承元 WebResponse) |
ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
古い.
SerializationInfo インスタンスに、WebResponse をシリアル化するために必要なデータを設定します。 (継承元 WebResponse) |
適用対象
こちらもご覧ください
.NET