7.52 UPDATE_MEMBER_ATTRIBUTEプロシージャのシグネチャ1

特定の名前付きコレクション内の指定したメンバー属性を更新します。指定した名前のコレクションが、同じセッションのカレント・ユーザー用およびカレント・アプリケーションID用として存在しないと、アプリケーション・エラーが発生します。順序番号p_seqで指定したメンバーが存在しないと、アプリケーション・エラーが発生します。指定した属性番号が無効であるか、または1から50の範囲外であると、エラーが発生します。4,000バイトを超える属性値は、4,000バイトに切り捨てられます。

構文

APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
    p_collection_name IN VARCHAR2,
    p_seq IN NUMBER,
    p_attr_number IN NUMBER,
    p_attr_value  IN VARCHAR2);

パラメータ

注意:

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

表7-28 UPDATE_MEMBER_ATTRIBUTEのシグネチャ1のパラメータ

パラメータ 説明

p_collection_name

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

p_seq

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

p_attr_number

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

p_attr_value

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

Departmentsというコレクションの2番目のメンバーを更新します(1つ目のメンバー属性をEngineeringに、2つ目のメンバー属性をSalesに更新します)。

BEGIN
    APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE (
        p_collection_name => 'Departments',
        p_seq => 2,
        p_attr_number => 1,
        p_attr_value => 'Engineering');
END;