Cookie を保存し、結果が正しければ 0 を、そうでない場合は他の任意の値を返します。

構文

SetCookie( Name,  Value [ , Path ] [ , Exp-date ] [ , Domain-name ] [ , Secure ] )



入力値の説明:

Name
     Cookie の名前です。Character タイプです。
Value
     格納する値です。Character タイプです。値はブラウザーに送信する前にエンコードされます。
Path
     Cookie が有効になっている Web パネルのパスです。Character タイプです。パスを指定しないと、Cookie が格納されているディレクトリーとそのサブディレクトリーにある Web パネルで有効になっていると見なされます。「/」が指定されている場合は、この Cookie はドメイン全体に対して有効です。
Exp-date
     Cookie の有効期限です。Date タイプまたは DateTime タイプです。指定されていない場合、ブラウザーのセッションを閉じると期限切れとなります。
Domain-name
Cookie が有効なドメインです。Character タイプです。既定のドメインは、Cookie が作成されたドメインです。
Secure
Numeric タイプです。1 にすると、接続が安全な (HTTPS を使用) 場合のみ、Cookie が送信されます。0 にすると、Cookie が常に送信されます。


戻されるタイプ:
Numeric

適用範囲

オブジェクト:Procedure、Transaction、Web Panel、Data Provider
ジェネレーター: .NET、.NET Framework、Java、Ruby (GeneXus X Evolution 3 まで)

例

次に、Cookie の格納方法の簡単な例をいくつか示します:
例 1

&Op = SetCookie('ID_USER', Str(UsrId), '/', CTOD('01/01/2010') )

ここでは、ID_USER という名前の Cookie が格納されています。この Cookie はドメイン全体で有効であり、値は UsrId 項目属性に対応します。期限は 2010 年 1 月 1 日です。
例 2

&OK = SetCookie('SESSION_ID_GX', &StrSession, '', Nullvalue(&Date) )

ここでは、SESSION_ID_GX という名前の Cookie が格納されています。この Cookie は、アプリケーションの Web パネルで有効で、その値は &StrSession という変数に対応します。この Cookie は、ブラウザーを閉じると期限切れとなります。
例 3

&Op = SetCookie('USR_CTRY', 'UY', '/', ADDYR(&Today, 1), 'otherdom.artech.com.uy', 1) 

ここでは、USR_CTR という名前の Cookie が格納されています。この Cookie は otherdom ドメインに対して有効であり、その値である UY は今日からちょうど一年後に期限切れとなります。

参考情報

GetCookie 関数