Metoda Package.ParseToolboxResource — (TextReader, ResourceManager)
Analizuje tekst osadzonego zasobu odpowiedni format, aby uzyskać informacje o tym, które elementy powinny zostać dodane do Przybornik.
Przestrzeń nazw: Microsoft.VisualStudio.Shell
Zestaw: Microsoft.VisualStudio.Shell.11.0 (w Microsoft.VisualStudio.Shell.11.0.dll)
Składnia
'Deklaracja
Protected Sub ParseToolboxResource ( _
resourceData As TextReader, _
localizedCategories As ResourceManager _
)
protected void ParseToolboxResource(
TextReader resourceData,
ResourceManager localizedCategories
)
Parametry
- resourceData
Typ: System.IO.TextReader
Czytnik tekst zawiera przybornik elementu danych w formacie opisanym w uwagi.
- localizedCategories
Typ: System.Resources.ResourceManager
Menedżer zasobów, która zapewnia zlokalizowany wyszukiwania nazwy kategorii w danych zasobów.Ten parametr może być null, w którym to przypadku bezpośrednio są używane nazwy kategorii.
Uwagi
Zasób tekst, który VSPackage analizuje za pomocą ParseToolboxResource musi być osadzony w miejscu montażu i nazwa dostępne do VSPackage.
Tekst zasoby powinny zostać dodane do zestawu przez kliknięcie prawym przyciskiem myszy projekt Zgromadzenia, zaznaczenie Dodaj i Nowego elementu.Z Nowego elementu menu, zaznacz Plik tekstowy.Po dodaniu pliku tekstowego do projektu, należy ustawić jego Build Action właściwość, aby zasobów osadzonych.
Ta metoda może służyć do automatycznie dodawać elementy do przybornika.Dane zasobów jest przekazywana przez resourceData parametr i składa się z pliku tekstowego z następującego formatu:
; Comment
[CategoryName]
<class name>, <assembly name>
Nazwa kategorii może być lokalizowany przez localizedCategories Menedżera zasobów, który jest przekazywany do tej metody.localizedCategories Parametr może być null, w którym to przypadku nazwy kategorii nie są lokalizowane.
Nazwa zestawu może być w pełni kwalifikowana nazwa lub część nazwy.Jeśli nazwa częściowa jest przekazywana, ostatnio otwieranych zestawu o takiej nazwie częściowe jest załadowany.
Podczas przetwarzania nazw zestawów ParseToolboxResource, przeszukuje tylko katalogi określone w kluczach rejestru wpisu HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\<version>\AssemblyFolders, gdzie <version> jest numerem wersji wydania programu Visual Studio (na przykład 8.0)
[!UWAGA]
Ścieżka katalogu głównego z HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version> może być zastąpiona z alternatywnego katalogu głównego podczas inicjowania powłoki programu Visual Studio lub wykorzystanie DefaultRegistryRootAttribute.Aby uzyskać więcej informacji, zobacz Przełączniki wiersza polecenia (Visual Studio SDK) i DefaultRegistryRootAttribute.
Format podkluczach pod HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\<version>jest \AssemblyFolders
Nazwa |
Typ |
Dane |
Opis |
|---|---|---|---|
<FriendlyName> |
REG_SZ |
Ciąg zawierający w pełni kwalifikowaną ścieżkę do katalogu, który powinien zawierać zestawów używanych przez Visual Studio. |
Nazwa klucza, <FriendlyName>, może być dowolną wartością tak długo, jak jest on unikatowy.Klucz danych zawiera pełną ścieżkę do katalogu zawierającego zestawy, które mają być przeszukiwane przezParseToolboxResource |
Wszelkie VSPackage wymagające użyć ParseToolboxResource musi się zarejestrować z Visual Studio środowiska, zapewniającej Przybornik elementy.
Atrybut ProvideToolboxItemsAttribute muszą być stosowane do wykonania VSPackage Package.W zależności od realizacji VSPackage ProvideToolboxFormatAttribute i ProvideToolboxItemConfigurationAttribute może być wymagane.
Aby uzyskać więcej informacji na piśmie Przybornik pozycja dostawcy, zobacz Zaawansowane rozwoju kontroli przybornika.
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..