7.55 UPDATE_MEMBER_ATTRIBUTEプロシージャのシグネチャ4

特定の名前付きコレクション内の指定したXMLTYPEメンバー属性を更新します。指定した名前のコレクションが、同じセッションのカレント・ユーザー用およびカレント・アプリケーションID用として存在しないと、アプリケーション・エラーが発生します。順序番号p_seqで指定したメンバーが存在しないと、アプリケーション・エラーが発生します。指定した属性番号が無効であるか、または有効な範囲(現在、XMLTYPEでは1のみ)の外であると、エラーが発生します。

構文

APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
    p_collection_name IN VARCHAR2,
    p_seq IN NUMBER,
    p_xmltype_number IN NUMBER,
    p_xmltype_value  IN BLOB);

パラメータ

注意:

4,000文字を超える文字属性は、4,000文字に切り捨てられます。また、追加されるメンバーの数は、1番目の配列内の要素の数に基づきます。

表7-31 UPDATE_MEMBER_ATTRIBUTEのシグネチャ4のパラメータ

パラメータ 説明

p_collection_name

コレクションの名前。最大長は255バイトです。コレクション名は大/小文字が区別されず、大文字に変換されます。このコレクションが、カレント・ユーザーの指定された名前で、同じセッションに存在しないと、エラーが戻されます。

p_seq

更新するコレクション・メンバーの順序番号。

p_xmltype_number

更新するXMLTYPEメンバー属性の属性番号。有効な値は1です。この範囲外の番号はすべて無視されます。

p_xmltype_value

更新するXMLTYPEメンバー属性の属性値。

次の例では、Departmentsというコレクションのコレクション順序番号2の1つ目のXML属性のみをXMLType変数の値l_xmltype_contentに設定します。

BEGIN
    APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
        p_collection_name => 'Departments',
        p_seq => 2,
        p_xmltype_number => 1,
        p_xmltype_value => l_xmltype_content);
END;