IVsSettingsWriter Arabirimi

Makale
01/24/2017

VSPackages yapılandırma bilgilerini depolamak için bir mekanizma sağlar Visual Studio ayarları dosyası.

Ad alanı: Microsoft.VisualStudio.Shell.Interop
Derleme: Microsoft.VisualStudio.Shell.Interop.8.0 (Microsoft.VisualStudio.Shell.Interop.8.0.dll içinde)

Sözdizimi

[GuidAttribute("0F1CF980-AFC6-406E-958D-7F24287E3916")]
[InterfaceTypeAttribute(1)]
public interface IVsSettingsWriter

[GuidAttribute("0F1CF980-AFC6-406E-958D-7F24287E3916")]
[InterfaceTypeAttribute(1)]
public interface class IVsSettingsWriter

[<GuidAttribute("0F1CF980-AFC6-406E-958D-7F24287E3916")>]
[<InterfaceTypeAttribute(1)>]
type IVsSettingsWriter = interface end

<GuidAttribute("0F1CF980-AFC6-406E-958D-7F24287E3916")>
<InterfaceTypeAttribute(1)>
Public Interface IVsSettingsWriter

Yöntemler

	Adı	Açıklama
	ReportError(String, UInt32)	Ayarları dosyaya yazma işlemi hata durumunu raporlar.
	WriteCategoryVersion(Int32, Int32, Int32, Int32)	Depolanmış bir kategori sürüm nesnenin değerini ayarlar Visual Studio ayarları dosyası.
	WriteSettingAttribute(String, String, String)
	WriteSettingBoolean(String, Int32)	Değer bir Boole nesnesinin depolar Visual Studio ayarları dosyası.
	WriteSettingBytes(String, Byte[], Int32)	Bir dizide değerlerini depolar Visual Studio ayarları dosyası.
	WriteSettingLong(String, Int32)	Bir uzun nesnesinde değerini depolar Visual Studio ayarları dosyası.
	WriteSettingString(String, String)	Bir dize değeri depolar Visual Studio ayarları dosyası.
	WriteSettingXml(Object)	Bir XML nesnesine değerini depolar Visual Studio ayarları dosyası.
	WriteSettingXmlFromString(String)	Bir XML ayarının değeri bir dize nesnesi olarak depolar Visual Studio ayarları dosyası.

Açıklamalar

Bu arabirim, ortamı tarafından uygulanır.

Arayanlar için Notlar

Çağrı IVsSettingsWriter VSPackage'nın yapılandırma bilgilerini depolarken Visual Studio ayarları dosyası.

Uygulayanlar için Notlar

Destek için kayıtlı VSPackages Visual Studio mekanizması yaptığınız ayarları kullanımını IVsSettingsWriter. Destek olarak VSPackage kaydetme hakkında daha fazla bilgi için Visual Studio ayarları mekanizması bkz kullanıcı ayarları için destek.

Ne zaman bir ayar dışa aktarma işlemi seçildi gelen içeri/dışarı aktarma ayarları özelliği IDE'nin üzerinde kullanılabilir Araçları menüsünde ortamı geçirir bir IVsSettingsWriter yapılandırma verilerini yazmak için arabirimi kullanan bir VSPackage'nın ayarları dışarı aktarma yöntemi için arabirim.Visual Studio SDK Birkaç verme yöntemi destekler:

Birlikte çalışma derlemesi VSPackages tabanlı için verme yöntemini VSPackage'nın uygulamasıdır IVsUserSettings arabirimin ExportSettings.
Çoğu paket çerçevesi ile yönetilen VSPackages tabanlı için verme yöntemini VSPackage'nın uygulamasıdır IProfileManager arabirimin SaveSettingsToXml.
VSPackages uygulama paketi çerçevesi ile yönetilen tabanlı için DialogPage dışarı aktarma yöntemini arabirimdir o arabirimin SaveSettingsToXml.

Daha fazla bilgi için bkz: nasıl yapılır: dışarı aktarma ayarları tarafından kullanarak birlikte çalışma derlemeleri veya dışarı aktarma ayarları.

[!NOT]

Kullanarak depolanan tüm verileri yanı sıra IVsSettingsWriter yöntemleri, IDE saydam olarak her zaman sürümü depolar Visual Studio yapılandırma verilerini dışa aktarmak için kullanılır.

[!NOT]

Arabellekler veya dize depolarken en iyi boyutu depolanan arabellek veya dize yanı sıra nesnesi ile kaydetmek için uygulamadır. Bu boyut bilgileri her zaman dizesinin kaydedilmiş arabellek alınırken arabellek taşmaları önlemek için kullanılmalıdır.

Örnekler

Aşağıdaki örnekte, bir uygulama tarafından çağrılan bir yöntemdir ExportSettings, yöntem biri olan depolanması için arabellek boyutu üç ayarları değerlere, yazar.

HRESULT ExportSettings_CommandBars(IVsSettingsWriter *pSettings)
{
    if (!pSettings)
        return E_INVALIDARG;

    hr = pSettings->WriteSettingString(c_szFirstSettingName, L"Value1");
    IfFailGo(hr);

    int cRandomTrash = 12345;
    BYTE *pRandomTrash = (BYTE *)VSAlloc(cRandomTrash);
    if (pRandomTrash){
        hr = pSettings->WriteSettingBytes(c_szRandomTrashBytes, pRandomTrash, cRandomTrash);
        IfFailGo(hr);
        hr = pSettings->WriteSettingLong(c_szRandomTrashLength, cRandomTrash);
        IfFailGo(hr);
    }

 Error:
    return hr;
};

Ayrıca bkz.

IVsSettingsReader
ExportSettings
Microsoft.VisualStudio.Shell.Interop Ad alanı
Kullanıcı ayarları için destek
Nasıl yapılır: birlikte çalışma derlemeleri kullanarak ayarlarını Dışarı Aktar
Dışarı aktarma ayarları
Working with Settings

Başa dön

Aracılığıyla paylaş