Cookie Sınıf

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.Primitives.dll

Kaynak:

Cookie.cs

Tanımlama bilgilerini yönetmek için kullanılan bir dizi özellik ve yöntem sağlar. Bu sınıf devralınamaz.

public ref class Cookie sealed

public sealed class Cookie

type Cookie = class

Public NotInheritable Class Cookie

Devralma

Object

Cookie

Örnekler

Aşağıdaki örnek bir URL'ye istek gönderir ve yanıtta döndürülen tanımlama bilgilerini görüntüler.

#using <System.dll>

using namespace System;
using namespace System::Net;

// This example is run at the command line.
// Specify one argument: the name of the host to 
// send the request to.
// If the request is sucessful, the example displays the contents of the cookies
// returned by the host.
int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   if ( args == nullptr || args->Length != 2 )
   {
      Console::WriteLine( "Specify the URL to receive the request." );
      Environment::Exit( 1 );
   }

   
   HttpWebRequest^ request = dynamic_cast<HttpWebRequest^>(WebRequest::Create( args[ 1 ] ));
   request->CookieContainer = gcnew CookieContainer;
   HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->GetResponse());
   response->Cookies = request->CookieContainer->GetCookies( request->RequestUri );
   
   // Print the properties of each cookie.
   System::Collections::IEnumerator^ myEnum = response->Cookies->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Cookie^ cook = safe_cast<Cookie^>(myEnum->Current);
      Console::WriteLine( "Cookie:" );
      Console::WriteLine( "{0} = {1}", cook->Name, cook->Value );
      Console::WriteLine( "Domain: {0}", cook->Domain );
      Console::WriteLine( "Path: {0}", cook->Path );
      Console::WriteLine( "Port: {0}", cook->Port );
      Console::WriteLine( "Secure: {0}", cook->Secure );
      Console::WriteLine( "When issued: {0}", cook->TimeStamp );
      Console::WriteLine( "Expires: {0} (expired? {1})", cook->Expires, cook->Expired );
      Console::WriteLine( "Don't save: {0}", cook->Discard );
      Console::WriteLine( "Comment: {0}", cook->Comment );
      Console::WriteLine( "Uri for comments: {0}", cook->CommentUri );
      Console::WriteLine( "Version: RFC {0}", cook->Version == 1 ? (String^)"2109" : "2965" );
      
      // Show the string representation of the cookie.
      Console::WriteLine( "String: {0}", cook );
      
   }

}

// Output from this example will be vary depending on the host name specified,
// but will be similar to the following.
/*
Cookie:
CustomerID = 13xyz
Domain: .contoso.com
Path: /
Port:
Secure: False
When issued: 1/14/2003 3:20:57 PM
Expires: 1/17/2013 11:14:07 AM (expired? False)
Don't save: False
Comment: 
Uri for comments:
Version: RFC 2965
String: CustomerID = 13xyz
*/

using System.Net;
using System;
namespace Examples.System.Net.Cookies
{
    // This example is run at the command line.
    // Specify one argument: the name of the host to
    // send the request to.
    // If the request is sucessful, the example displays the contents of the cookies
    // returned by the host.

    public class CookieExample
    {
        public static void Main(string[] args)
        {
            if (args == null || args.Length != 1)
            {
                Console.WriteLine("Specify the URL to receive the request.");
                Environment.Exit(1);
            }
            var request = (HttpWebRequest)WebRequest.Create(args[0]);
            request.CookieContainer = new CookieContainer();

            using (var response = (HttpWebResponse) request.GetResponse())
            {
                // Print the properties of each cookie.
                foreach (Cookie cook in response.Cookies)
                {
                    Console.WriteLine("Cookie:");
                    Console.WriteLine($"{cook.Name} = {cook.Value}");
                    Console.WriteLine($"Domain: {cook.Domain}");
                    Console.WriteLine($"Path: {cook.Path}");
                    Console.WriteLine($"Port: {cook.Port}");
                    Console.WriteLine($"Secure: {cook.Secure}");

                    Console.WriteLine($"When issued: {cook.TimeStamp}");
                    Console.WriteLine($"Expires: {cook.Expires} (expired? {cook.Expired})");
                    Console.WriteLine($"Don't save: {cook.Discard}");
                    Console.WriteLine($"Comment: {cook.Comment}");
                    Console.WriteLine($"Uri for comments: {cook.CommentUri}");
                    Console.WriteLine($"Version: RFC {(cook.Version == 1 ? 2109 : 2965)}");

                    // Show the string representation of the cookie.
                    Console.WriteLine($"String: {cook}");
                }
            }
        }
    }
}

// Output from this example will be vary depending on the host name specified,
// but will be similar to the following.
/*
Cookie:
CustomerID = 13xyz
Domain: .contoso.com
Path: /
Port:
Secure: False
When issued: 1/14/2003 3:20:57 PM
Expires: 1/17/2013 11:14:07 AM (expired? False)
Don't save: False
Comment:
Uri for comments:
Version: RFC 2965
String: CustomerID = 13xyz
*/

Imports System.Net

' This example is run at the command line.
' Specify one argument: the name of the host to 
' receive the request.
' If the request is sucessful, the example displays the contents of the cookies
' returned by the host.

Public Class CookieExample
    
    Public Shared Sub Main(args() As String)
        If args Is Nothing OrElse args.Length <> 1 Then
            Console.WriteLine("Specify the URL to receive the request.")
            Environment.Exit(1)
        End If
        Dim request As HttpWebRequest = WebRequest.Create(args(0))
        request.CookieContainer = New CookieContainer()
    
        Using response As HttpWebResponse = request.GetResponse()
            ' Print the properties of each cookie.
            For Each cook As Cookie In response.Cookies
                Console.WriteLine("Cookie:")
                Console.WriteLine($"{cook.Name} = {cook.Value}")
                Console.WriteLine($"Domain: {cook.Domain}")
                Console.WriteLine($"Path: {cook.Path}")
                Console.WriteLine($"Port: {cook.Port}")
                Console.WriteLine($"Secure: {cook.Secure}")
    
                Console.WriteLine($"When issued: {cook.TimeStamp}")
                Console.WriteLine($"Expires: {cook.Expires} (expired? {cook.Expired})")
                Console.WriteLine($"Don't save: {cook.Discard}")
                Console.WriteLine($"Comment: {cook.Comment}")
                Console.WriteLine($"Uri for comments: {cook.CommentUri}")
                Console.WriteLine($"Version: RFC {If(cook.Version = 1, 2109, 2965)}")
    
                ' Show the string representation of the cookie.
                Console.WriteLine($"String: {cook}")
            Next
        End Using
    End Sub
End Class



' Output from this example will be vary depending on the host name specified,
' but will be similar to the following.
'
'Cookie:
'CustomerID = 13xyz
'Domain: .contoso.com
'Path: /
'Port:
'Secure: False
'When issued: 1/14/2003 3:20:57 PM
'Expires: 1/17/2013 11:14:07 AM (expired? False)
'Don't save: False
'Comment: 
'Uri for comments:
'Version: RFC 2965
'String: CustomerID = 13xyz
'

Açıklamalar

Cookie sınıfı, http yanıtları ile alınan tanımlama bilgileri hakkında bilgi almak için bir istemci uygulaması tarafından kullanılır. HTTP yanıt üst bilgilerinin ayrıştırılması sırasında aşağıdaki tanımlama bilgisi biçimleri desteklenir: özgün Netscape belirtimi, RFC 2109 ve RFC 2965.

örneğinin ilk özellik değerlerinin Cookielistesi için çeşitli Cookie oluşturuculara bakın.

Oluşturucular

Cookie()	Cookie sınıfının yeni bir örneğini başlatır.
Cookie(String, String)	belirtilen Name ve Valueile sınıfının yeni bir örneğini Cookie başlatır.
Cookie(String, String, String)	Belirtilen Name, Valueve Pathile sınıfının yeni bir örneğini Cookie başlatır.
Cookie(String, String, String, String)	Belirtilen Name, , ValuePathve Domainile sınıfının yeni bir örneğini Cookie başlatır.

Özellikler

Comment	Sunucunun bir öğesine ekleyebilecekleri bir Cookieaçıklama alır veya ayarlar.
CommentUri	Sunucunun ile Cookiesağlayabilecekleri bir URI açıklamasını alır veya ayarlar.
Discard	Sunucu tarafından ayarlanan atma bayrağını alır veya ayarlar.
Domain	geçerli olduğu URI'yi Cookie alır veya ayarlar.
Expired	öğesinin geçerli durumunu Cookiealır veya ayarlar.
Expires	için Cookie sona erme tarihini ve saatini olarak DateTimealır veya ayarlar.
HttpOnly	Sayfa betiğinin veya diğer etkin içeriğin bu tanımlama bilgilerine erişip erişemeyeceğini belirler.
Name	için Cookieadını alır veya ayarlar.
Path	Geçerli olduğu Cookie URI'leri alır veya ayarlar.
Port	geçerli olan TCP bağlantı noktalarının Cookie listesini alır veya ayarlar.
Secure	bir Cookieöğesinin güvenlik düzeyini alır veya ayarlar.
TimeStamp	Tanımlama bilgisinin olarak DateTimeverildiği zamanı alır.
Value	için Cookieöğesini Value alır veya ayarlar.
Version	Tanımlama bilgisinin uyumlu olduğu HTTP durum bakımının sürümünü alır veya ayarlar.

Yöntemler

Equals(Object)	Equals(Object) yöntemini geçersiz kılar.
GetHashCode()	GetHashCode() yöntemini geçersiz kılar.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	ToString() yöntemini geçersiz kılar.

Ayrıca bkz.

• CookieCollection
• CookieContainer
• CookieException