Klasa DesignSurfaceExtensionAttribute

Artykuł
10/27/2012

Powiadamia Visual Studio środowiska, który zapewnia VSPackage Type wykonania usługi, aby dostosować lub rozszerzyć usług świadczonych przez każde wprowadzenie DesignSurface w projektancie załadować czasu.

Hierarchia dziedziczenia

System.Object
  System.Attribute
    Microsoft.VisualStudio.Shell.RegistrationAttribute
      Microsoft.VisualStudio.Shell.Design.DesignSurfaceExtensionAttribute

Przestrzeń nazw: Microsoft.VisualStudio.Shell.Design
Zestaw: Microsoft.VisualStudio.Shell.Design (w Microsoft.VisualStudio.Shell.Design.dll)

Składnia

'Deklaracja
<AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple := True, Inherited := True)> _
Public NotInheritable Class DesignSurfaceExtensionAttribute _
    Inherits RegistrationAttribute

[AttributeUsageAttribute(AttributeTargets.Class, AllowMultiple = true, Inherited = true)]
public sealed class DesignSurfaceExtensionAttribute : RegistrationAttribute

Typ DesignSurfaceExtensionAttribute uwidacznia następujące elementy członkowskie.

Konstruktorzy

	Nazwa	Opis
	DesignSurfaceExtensionAttribute	Tworzy nowe wystąpienie DesignSurfaceExtensionAttribute klasy danego obiektu jako zapewniające wykonania VSPackage DesignSurfaceExtension.

Początek

Właściwości

	Nazwa	Opis
	ExtensionType	Type Obiektu zarejestrowane jako zapewniające VSPackage z implementacją DesignSurfaceExtension do dostosowywania powierzchnie projektu.
	LoadAtIdle	Kontroluje czas, względem ładowania projektanta, używany przez VSPackage, rozszerzenia, świadczone przez wprowadzenie w życie DesignSurfaceExtensionAttribute zarejestrowane przez DesignSurfaceExtensionAttribute są zainstalowane.
	TypeId	Pobiera bieżące wystąpienie tego atrybutu. (Odziedziczone z RegistrationAttribute).

Początek

Metody

	Nazwa	Opis
	Equals	Infrastruktura. Zwraca wartość, która wskazuje, czy to wystąpienie jest równa określonego obiektu. (Odziedziczone z Attribute).
	GetHashCode	Zwraca kod skrótu dla tego wystąpienia. (Odziedziczone z Attribute).
	GetType	Pobiera Type bieżącej instancji. (Odziedziczone z Object).
	IsDefaultAttribute	Gdy zastąpiony w klasie pochodnej, wskazuje, czy wartość to wystąpienie jest wartością domyślną dla klasy pochodnej. (Odziedziczone z Attribute).
	Match	Gdy zastąpiony w klasie pochodnej, zwraca wartość wskazującą, czy to wystąpienie jest równa określonego obiektu. (Odziedziczone z Attribute).
	Register	Rejestruje rozszerzenia powierzchni projektu. (Zastępuje RegistrationAttribute.Register(RegistrationAttribute.RegistrationContext)).
	ToString	Zwraca ciąg, który reprezentuje bieżącego obiektu. (Odziedziczone z Object).
	Unregister	Powoduje usunięcie klucza rejestru rozszerzenia powierzchni projektu. (Zastępuje RegistrationAttribute.Unregister(RegistrationAttribute.RegistrationContext)).

Początek

Jawne implementacje interfejsu

	Nazwa	Opis
	_Attribute.GetIDsOfNames	Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłki. (Odziedziczone z Attribute).
	_Attribute.GetTypeInfo	Pobiera informacje o typie dla obiektu, który można uzyskać informacji o typie dla interfejsu. (Odziedziczone z Attribute).
	_Attribute.GetTypeInfoCount	Pobiera numer typu informacji interfejsów, że obiekt zawiera (0 lub 1). (Odziedziczone z Attribute).
	_Attribute.Invoke	Zapewnia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone z Attribute).

Początek

Uwagi

Atrybutu kontekstu

Stosuje się do	Klasy, zapewniając VSPackages przez zaimplementowanie IVsPackage interfejsu lub Package interfejsu.
Powtarzalne	Nr
Wymagane atrybuty	Wystąpienia każdej ProvideObjectAttribute i ProvideServiceAttribute skonstruowane z Type klasy, zarejestrowanych przez DesignSurfaceExtensionAttribute jako DesignSurfaceExtension.
Nieprawidłowe atrybuty	Brak

To Attribute Określa Type jako wykonania usługi, zapewniając dostosowania lub rozszerzenia usług świadczonych przez każde wprowadzenie DesignSurface używany przez VSPackage.

DesignSurfaceExtensionAttributejest używany tylko do celów rejestracji i nie wpływa na sposób działania kodu w czasie wykonywania.

Instancji tej Attribute powinien być stosowany tylko do wykonywania klas Package do VSPackage.

Przykłady

W poniższym przykładzie oświadcza, że VSPackage CustomDesigner, pod warunkiem klasy CustomSurfaceExt dostosować projekt powierzchni go używa.

[ProvideServiceAttribute(typeof(CustomSurfaceExt))]
[ProvideObjectAttribute(typeof(CustomSurfaceExt))]
[DesignSurfaceExtension(typeof(CustomSurfaceExt))] 
class CustomDesigner : Package

Bezpieczeństwo wątku

Wszystkie publiczne static (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Wystąpienia elementów członkowskich nie dają gwarancji bezpieczeństwa wątków.