ISettingsManager.SetValueAsync(String, Object, Boolean) Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Settings

Assembly:: Microsoft.VisualStudio.Utilities.dll

Package:: Microsoft.VisualStudio.Utilities v17.12.40391

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Sets the value of a property.

public:
 System::Threading::Tasks::Task ^ SetValueAsync(System::String ^ name, System::Object ^ value, bool isMachineLocal);

public System.Threading.Tasks.Task SetValueAsync (string name, object value, bool isMachineLocal);

abstract member SetValueAsync : string * obj * bool -> System.Threading.Tasks.Task

Public Function SetValueAsync (name As String, value As Object, isMachineLocal As Boolean) As Task

Parameters

name: String

The name of the setting.

value: Object

An object which will be serialized and persisted as the new value.

isMachineLocal: Boolean

True if the value is machine-local, otherwise false.

Returns

Task

Returns Task.

Exceptions

ArgumentNullException

Thrown when name is null.

ArgumentException

Thrown when name is empty.

SerializationException

Thrown when the given object cannot be serialized.

IOException

Thrown when the value cannot be persisted to the private store (for example, because the disk is full).

SettingTooLargeException

Thrown when the serialized object exceeds the maximum allowed size.

SettingNameTooLongException

Thrown when name exceeds the maximum allowed length.

Remarks

This method is safe to access from any thread.

Applies to

Partilhar via