PreferencesStore.SetValue Método

Definición

Espacio de nombres:

Microsoft.Web.Management.Client

Ensamblado:

Microsoft.Web.Management.dll

Quita, agrega o reemplaza un elemento en el almacén de preferencias.

Sobrecargas

SetValue(String, Boolean, Boolean)	Quita, agrega o reemplaza un elemento en el almacén de preferencias mediante los valores booleanos especificados.
SetValue(String, Int32, Int32)	Quita, agrega o reemplaza un elemento en el almacén de preferencias mediante los valores enteros especificados.
SetValue(String, String, String)	Quita, agrega o reemplaza un elemento en el almacén de preferencias mediante los valores de cadena especificados.

SetValue(String, Boolean, Boolean)

Quita, agrega o reemplaza un elemento en el almacén de preferencias mediante los valores booleanos especificados.

public:
 void SetValue(System::String ^ name, bool value, bool defaultValue);

public void SetValue (string name, bool value, bool defaultValue);

member this.SetValue : string * bool * bool -> unit

Public Sub SetValue (name As String, value As Boolean, defaultValue As Boolean)

Parámetros

name

String

Nombre del elemento de almacén.

value

Boolean

Valor que se va a establecer para el elemento de almacén con nombre.

defaultValue

Boolean

Indicador de valor de restablecimiento.

Excepciones

ArgumentNullException

El valor de name es null o está vacío.

Ejemplos

En el ejemplo siguiente se guarda un bool elemento en el almacén, se cambia el valor y, a continuación, se elimina el elemento.

void TrcBoolVal(string name) {

    PreferencesStore store = MyPrefStore;

    bool b = store.ContainsValue(name);
    Trace.WriteLine("ContainsValue(\"" + name + "\") : "
        + b.ToString());

    if (b == false)
        return;

    bool myCnfgBoolVal = store.GetValue(name, false);
    Trace.WriteLine(name + " Value: "
    + myCnfgBoolVal.ToString());

}

void TrcSetBool() {

    PreferencesStore store = MyPrefStore;

    string name = "MyBool";

    store.SetValue(name, true, false);
    TrcBoolVal(name);

    store.SetValue(name, false, true);
    TrcBoolVal(name);

    store.SetValue(name, true, true);
    TrcBoolVal(name);
}

Comentarios

Si los value parámetros y defaultValue son los mismos, se quita el elemento del almacén.

SetValue(String, Int32, Int32)

Quita, agrega o reemplaza un elemento en el almacén de preferencias mediante los valores enteros especificados.

public:
 void SetValue(System::String ^ name, int value, int defaultValue);

public void SetValue (string name, int value, int defaultValue);

member this.SetValue : string * int * int -> unit

Public Sub SetValue (name As String, value As Integer, defaultValue As Integer)

Parámetros

name

String

Nombre del elemento de almacén.

value

Int32

Valor que se va a establecer para el elemento de almacén con nombre.

defaultValue

Int32

Indicador de valor de restablecimiento.

Excepciones

ArgumentNullException

El valor de name es null o está vacío.

Ejemplos

En el ejemplo siguiente se guarda un int elemento en el almacén, se cambia el valor y, a continuación, se elimina el elemento.

void TrcVal(string name, int defVal) {

    PreferencesStore store = MyPrefStore;

    bool b = store.ContainsValue(name);
    if (b == false)
        Trace.WriteLine(name + " is not in store");


    int intVal = store.GetValue(name, defVal);
    Trace.WriteLine(name + " Value = "
        + intVal.ToString());

}

void TrcSetInt() {

    PreferencesStore store = MyPrefStore;
    string name = "MyInt";

    store.SetValue(name, 12, 321);
    TrcVal(name, 45678);

    store.SetValue(name, 321, 12);
    TrcVal(name, 45678);

    store.SetValue(name, 12, 12);
    TrcVal(name, 45678);
}

Comentarios

Si los value parámetros y defaultValue son los mismos, este método quita el elemento del almacén.

SetValue(String, String, String)

Quita, agrega o reemplaza un elemento en el almacén de preferencias mediante los valores de cadena especificados.

public:
 void SetValue(System::String ^ name, System::String ^ value, System::String ^ defaultValue);

public void SetValue (string name, string value, string defaultValue);

member this.SetValue : string * string * string -> unit

Public Sub SetValue (name As String, value As String, defaultValue As String)

Parámetros

name

String

Nombre del elemento de almacén.

value

String

Valor que se va a establecer para el elemento de almacén con nombre.

defaultValue

String

Indicador de valor de restablecimiento.

Excepciones

ArgumentNullException

El name parámetro o value es o está null vacío.

Ejemplos

En el ejemplo siguiente se guarda un elemento de cadena en el almacén, se cambia el valor y, a continuación, se elimina el elemento.

void TrcVal(string name, string strDefault) {

    PreferencesStore store = MyPrefStore;

    bool b = store.ContainsValue(name);
    if (b == false)
        Trace.WriteLine(name + " Not in store");

    string strVal = store.GetValue(name, strDefault);
    Trace.WriteLine(name + "Value = \""
        + strVal + "\"");

}

void TrcSetStrng() {

    PreferencesStore store = MyPrefStore;
    string name = "MyString";
    string sA = "abc";
    string sX = "X-12345";
    string sDefault = "My Default String";

    store.SetValue(name, sA, sX);
    TrcVal(name, sDefault);

    store.SetValue(name, sX, sA);
    TrcVal(name, sDefault);

    store.SetValue(name, sA, sA);
    TrcVal(name, sDefault);
}

Comentarios

Si los value parámetros y defaultValue son los mismos, se quita el elemento del almacén.