C# HTTP系列7 HttpWebRequest.Method属性

系列目录     【已更新最新开发文章，点击查看详细】

HttpWebRequest.Method属性，获取或设置请求的方法。用于联系 Internet 资源的请求方法。 默认值为 GET。

System.Net 命名空间下提供了 WebRequestMethods 类，该类包含了 Http、File、Ftp 三个类。如下：

namespace System.Net
{
  /// <summary>
  ///   容器类 <see cref="T:System.Net.WebRequestMethods.Ftp" />, 
     ///         <see cref="T:System.Net.WebRequestMethods.File" />, 
  ///<see cref="T:System.Net.WebRequestMethods.Http" /> 类。
  ///   无法继承此类
  /// </summary>
  public static class WebRequestMethods
  {
    /// <summary>表示可用于 HTTP 请求的 HTTP 协议方法的类型。</summary>
    public static class Http
    {
      /// <summary>代表 HTTP GET 协议方法 </summary>
      public const string Get = "GET";
      
      /// <summary>表示与一个代理，它可以动态切换到隧道，如下所示的 SSL 隧道的情况下使用的 HTTP 连接协议方法。</summary>
      public const string Connect = "CONNECT";
      
      /// <summary>
      ///   表示 HTTP Head 协议方法。
      ///    HEAD 方法等同于 GET 只是服务器仅在响应中，但不包括消息正文中返回消息头。
      /// </summary>
      public const string Head = "HEAD";
      
      /// <summary>表示用来替换实体由 URI 标识的 HTTP PUT 协议方法。</summary>
      public const string Put = "PUT";
      
      /// <summary>表示用于将新实体添加作为发布到的 URI 的 HTTP POST 协议方法。</summary>
      public const string Post = "POST";
      
      /// <summary>
      ///   表示在由请求统一资源标识符 (URI) 指定的位置创建一个新集合 （如页的集合） 的 HTTP MKCOL 请求。
      /// </summary>
      public const string MkCol = "MKCOL";
    }

    /// <summary>
    ///   表示文件可用于文件请求的协议方法的类型。
    ///    此类不能被继承。
    /// </summary>
    public static class File
    {
      /// <summary>表示用于从指定位置检索文件的文件时，变协议方法。</summary>
      public const string DownloadFile = "GET";
      
      /// <summary>表示用于将文件复制到指定位置的文件将放协议方法。</summary>
      public const string UploadFile = "PUT";
    }
    
    /// <summary>
    ///   表示可与一个 FTP 请求使用的 FTP 协议方法的类型。
    ///    此类不能被继承。
    /// </summary>
    public static class Ftp
    {
      /// <summary>表示用于从 FTP 服务器下载文件的 FTP RETR 协议方法。</summary>
      public const string DownloadFile = "RETR";
      
      /// <summary>代表获取 FTP 服务器上的文件的简短列表的 FTP NLIST 协议方法。</summary>
      public const string ListDirectory = "NLST";
      
      /// <summary>表示将文件上载到 FTP 服务器的 FTP STOR 协议方法。</summary>
      public const string UploadFile = "STOR";
      
      /// <summary>表示用于删除 FTP 服务器上的文件的 FTP DELE 协议方法。</summary>
      public const string DeleteFile = "DELE";
      
      /// <summary>表示用于将文件附加到 FTP 服务器上的现有文件的 FTP APPE 协议方法。</summary>
      public const string AppendFile = "APPE";
      
      /// <summary>表示用于检索 FTP 服务器上的文件的大小的 FTP SIZE 协议方法。</summary>
      public const string GetFileSize = "SIZE";
      
      /// <summary>表示将具有唯一名称的文件上载到 FTP 服务器的 FTP STOU 协议。</summary>
      public const string UploadFileWithUniqueName = "STOU";
      
      /// <summary>表示 FTP MKD 协议方法在 FTP 服务器上创建一个目录。</summary>
      public const string MakeDirectory = "MKD";
      
      /// <summary>代表删除目录的 FTP RMD 协议方法。</summary>
      public const string RemoveDirectory = "RMD";
      
      /// <summary>代表获取 FTP 服务器上的文件的详细的列表的 FTP LIST 协议方法。</summary>
      public const string ListDirectoryDetails = "LIST";
      
      /// <summary>表示要用于从 FTP 服务器上的文件检索日期时间戳的 FTP MDTM 协议方法。</summary>
      public const string GetDateTimestamp = "MDTM";
      
      /// <summary>代表打印当前工作目录的名称的 FTP PWD 协议方法。</summary>
      public const string PrintWorkingDirectory = "PWD";
      
      /// <summary>表示重命名一个目录的 FTP RENAME 协议方法。</summary>
      public const string Rename = "RENAME";
    }

其中 Http 类，表示可与 HTTP 请求一起使用的 HTTP 协议方法的类型

Connect	表示与代理一起使用的 HTTP CONNECT 协议方法，该代理可以动态切换到隧道，如 SSL 隧道的情况。
Get	表示一个 HTTP GET 协议方法。
Head	表示一个 HTTP HEAD 协议方法。 除了服务器在响应中只返回消息头不返回消息体以外，HEAD 方法和 GET 是一样的。
MkCol	表示一个 HTTP MKCOL 请求，该请求在请求 URI（统一资源标识符）指定的位置新建集合，如页的集合。
Post	表示一个 HTTP POST 协议方法，该方法用于将新实体作为补充发送到某个 URI。
Put	表示一个 HTTP PUT 协议方法，该方法用于替换 URI 标识的实体。

如果 ContentLength 属性设置为-1以外的任何值，则必须将 Method 属性设置为上载数据的协议属性。

 下面的代码示例设置Method属性设置为 POST。

// 设置为 'POST' 方式
myHttpWebRequest.Method = "POST";
Console.WriteLine ("\n请输入要发布到的数据 (http://www.contoso.com/codesnippets/next.asp) Uri :");

// 创建新的字符串对象以将数据发布到URL。
string inputData = Console.ReadLine ();


string postData = "firstone=" + inputData;
ASCIIEncoding encoding = new ASCIIEncoding ();
byte[] byte1 = encoding.GetBytes (postData);

// 设置要发布的数据的内容类型。
myHttpWebRequest.ContentType = "application/x-www-form-urlencoded";

// 设置要发布的字符串的内容长度。
myHttpWebRequest.ContentLength = byte1.Length;

Stream newStream = myHttpWebRequest.GetRequestStream ();

newStream.Write (byte1, 0, byte1.Length);
Console.WriteLine ("发送数据后“ContentLength”属性的值为 {0}", myHttpWebRequest.ContentLength);

// 关闭流对象。
newStream.Close ();

 

系列目录     【已更新最新开发文章，点击查看详细】