NSHttpCookie 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
NSHttpCookie(NSDictionary) |
建立新的 NSHttpCookie |
NSHttpCookie(NSObjectFlag) |
呼叫衍生類別的建構函式,以略過初始化,並只配置 物件。 |
NSHttpCookie(IntPtr) |
建立 Unmanaged 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。 |
NSHttpCookie(Cookie) |
從提供的 System.Net.Cookie 實例屬性建立新的 Cookie |
NSHttpCookie(String, String) |
使用提供的名稱和值建立新的 Cookie。 |
NSHttpCookie(String, String, String) |
使用提供的名稱、值和路徑建立新的 Cookie。 |
NSHttpCookie(String, String, String, String) |
使用提供的名稱、值、路徑和網域建立新的 Cookie。 |
NSHttpCookie(NSDictionary)
建立新的 NSHttpCookie
[Foundation.Export("initWithProperties:")]
public NSHttpCookie (Foundation.NSDictionary properties);
new Foundation.NSHttpCookie : Foundation.NSDictionary -> Foundation.NSHttpCookie
參數
- properties
- NSDictionary
具有 Cookie 值的字典。
- 屬性
備註
若要具現化 NSHTTPCookie 的實例,您需要傳遞 NSDictionary
實際的索引鍵必須是這個類別的公開金鑰靜態欄位之一, (、、、 KeyDomainKeyPathKeyCommentKeyExpiresKeyCommentUrlKeyVersionKeySecureKeyOriginUrl 、 KeyMaximumAgeKeyDiscard 和 KeyPort) 。 KeyValueKeyName
var properties = NSDictionary.FromObjectsAndKeys (new object [] { "MyCookieValue" }, new object [] { NSHttpCookie.KeyValue });
var cookie = new NSHttpCookie (properties);
適用於
NSHttpCookie(NSObjectFlag)
呼叫衍生類別的建構函式,以略過初始化,並只配置 物件。
protected NSHttpCookie (Foundation.NSObjectFlag t);
new Foundation.NSHttpCookie : Foundation.NSObjectFlag -> Foundation.NSHttpCookie
參數
未使用的 sentinel 值,傳遞 NSObjectFlag.Empty。
備註
當衍生類別在 Managed 程式碼中完全建構物件時,應該呼叫這個建構函式,並只想要讓執行時間配置和初始化 NSObject。 這是實作 Objective-C 所使用的雙步驟初始化程式的必要條件,第一個步驟是執行物件配置,第二個步驟是初始化物件。 當開發人員叫用採用 NSObjectFlag.Empty 的建構函式時,它們會利用直接路徑,而直接路徑會移至 NSObject,只設定物件的記憶體,並將 Objective-C 和 C# 物件系結在一起。 物件的實際初始化會由開發人員決定。
系結產生器通常會使用此建構函式來設定物件,但會防止實際初始化發生。 配置完成之後,建構函式必須初始化 物件。 使用系結產生器所產生的建構函式,這表示它會手動叫用其中一個 「init」 方法來初始化 物件。
如果開發人員使用 NSObjectFlag.Empty 路徑鏈結物件,開發人員必須負責完全初始化物件。
一般而言,如果開發人員的建構函式叫用 NSObjectFlag.Empty 基底實作,則它應該呼叫 Objective-C init 方法。 如果這不是這種情況,開發人員應該改為將其類別中的適當建構函式鏈結在一起。
忽略引數值,而且只會確保唯一執行的程式碼是建構階段是基本的 NSObject 配置和執行時間類型註冊。 通常鏈結看起來會像這樣:
//
// The NSObjectFlag merely allocates the object and registers the
// C# class with the Objective-C runtime if necessary, but no actual
// initXxx method is invoked, that is done later in the constructor
//
// This is taken from Xamarin.iOS's source code:
//
[Export ("initWithFrame:")]
public UIView (System.Drawing.RectangleF frame) : base (NSObjectFlag.Empty)
{
// Invoke the init method now.
var initWithFrame = new Selector ("initWithFrame:").Handle;
if (IsDirectBinding)
Handle = ObjCRuntime.Messaging.IntPtr_objc_msgSend_CGRect (this.Handle, initWithFrame, frame);
else
Handle = ObjCRuntime.Messaging.IntPtr_objc_msgSendSuper_CGRect (this.SuperHandle, initWithFrame, frame);
}
適用於
NSHttpCookie(IntPtr)
建立 Unmanaged 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。
protected internal NSHttpCookie (IntPtr handle);
new Foundation.NSHttpCookie : nativeint -> Foundation.NSHttpCookie
參數
- handle
-
IntPtr
nativeint
指向 Unmanaged 物件的指標 (控制碼) 。
備註
執行時間基礎結構會叫用此建構函式 () GetNSObject(IntPtr) ,為 Unmanaged Objective-C 物件的指標建立新的 Managed 標記法。 開發人員不應該直接叫用此方法,而是應該呼叫 GetNSObject 方法,因為它會防止 Managed 物件的兩個實例指向相同的原生物件。
適用於
NSHttpCookie(Cookie)
從提供的 System.Net.Cookie 實例屬性建立新的 Cookie
public NSHttpCookie (System.Net.Cookie cookie);
new Foundation.NSHttpCookie : System.Net.Cookie -> Foundation.NSHttpCookie
參數
- cookie
- Cookie
來自 .NET Framework 的現有 Cookie
備註
如果 cookie
為 Null,此建構函式會擲回 ArgumentNullException
適用於
NSHttpCookie(String, String)
NSHttpCookie(String, String, String)
使用提供的名稱、值和路徑建立新的 Cookie。
public NSHttpCookie (string name, string value, string path);
new Foundation.NSHttpCookie : string * string * string -> Foundation.NSHttpCookie
參數
- name
- String
Cookie 的名稱。 不可以是 null。
- value
- String
Cookie 的值。 不可以是 null。
- path
- String
在網域上套用 Cookie 的路徑。 使用 「/」 會將 Cookie 傳送至網域上的每個 URL。
備註
預設網域將用來確保已建立有效的實例
適用於
NSHttpCookie(String, String, String, String)
使用提供的名稱、值、路徑和網域建立新的 Cookie。
public NSHttpCookie (string name, string value, string path, string domain);
new Foundation.NSHttpCookie : string * string * string * string -> Foundation.NSHttpCookie
參數
- name
- String
Cookie 的名稱。 不可以是 null。
- value
- String
Cookie 的值。 不可以是 null。
- path
- String
在網域上套用 Cookie 的路徑。 使用 「/」 會將 Cookie 傳送至網域上的每個 URL。
- domain
- String
網域 (,例如與 Cookie 相關的 xamarin.com)
備註
如果 name
或 value
為 Null,則會擲回 ArgumentNullException。