Klasa DesignSurfaceExtension

Artykuł
10/27/2012

Klasa podstawowa dla dowolnego obiektu, świadczone przez VSPackage do wywołania przez Visual Studio środowiska po utworzeniu projektanta, aby dostosować lub rozszerzyć usług i metadane dostarczane przez każde wprowadzenie DesignSurface.

Hierarchia dziedziczenia

System.Object
Microsoft.VisualStudio.Shell.Design.DesignSurfaceExtension

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

Składnia

'Deklaracja
<ComVisibleAttribute(True)> _
Public MustInherit Class DesignSurfaceExtension _
    Implements IDisposable

[ComVisibleAttribute(true)]
public abstract class DesignSurfaceExtension : IDisposable

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

Konstruktorzy

	Nazwa	Opis
	DesignSurfaceExtension	Utwórz nowe wystąpienie DesignSurfaceExtension klasy.

Początek

Właściwości

	Nazwa	Opis
	Surface	Pobiera powierzchni projektu, który to rozszerzenie zostało zainicjowane z użyciem.

Początek

Metody

	Nazwa	Opis
	Dispose()	Usuwa ten obiekt i jego zasobów.
	Dispose(Boolean)	Usuwa ten obiekt i jego zasobów.
	Equals	Określa, czy określony obiekt jest równa bieżącego obiektu. (Odziedziczone z Object).
	Finalize	Niszczy obiekt. (Zastępuje Object.Finalize()).
	GetHashCode	Służy jako funkcja mieszania dla określonego typu. (Odziedziczone z Object).
	GetType	Pobiera Type bieżącej instancji. (Odziedziczone z Object).
	Initialize	Inicjuje rozszerzenia powierzchni projektu.
	MemberwiseClone	Tworzy kopię płytkie bieżące Object. (Odziedziczone z Object).
	OnComponentCreated	Metoda ta jest wywoływana, gdy jest tworzony nowy składnik, ale przed tym, że składnik jest dodawana do projektanta.
	OnDesignerCreated(IDesigner)	Przestarzałe. Metoda ta jest wywoływana, gdy tworzone jest nowe projektanta.
	OnDesignerCreated(IComponent, IDesigner, Boolean)	Metoda ta jest wywoływana, gdy tworzone jest nowe projektanta.
	ToString	Zwraca ciąg, który reprezentuje bieżącego obiektu. (Odziedziczone z Object).

Początek

Uwagi

DesignSurfaceExtensionObiekt musi być zarejestrowany przez zastosowanie następujących Attribute wystąpień stosowane do VSPackage Package wykonania:

DesignSurfaceExtensionAttributeAby powiadomić Visual Studio środowiska, DesignSurfaceExtension realizacji jako zapewniające dostosowanie powierzchni projektu w czasie ładowania projektanta.
ProvideObjectAttributeAby wskazać, że VSPackage zawiera wystąpienia DesignSurfaceExtension obiektu.
ProvideServiceAttributeAby wskazać, że DesignSurfaceExtension realizacji jest dostarczana przez VSPackage jako Visual Studio SDK usługi.

Wniosek został już załadowany przez Visual Studio środowisko może dostarczyć dynamicznej modyfikacji usług lub metadane na powierzchni lub w części Tworzenie projektowanym formularzu Obsługa DesignerCreated zdarzenia.

Jednakże VSPackages są ładowane na żądanie, pakiet może nie mieć został załadowany przez Visual Studio środowiska przed załadunku powierzchni projektu i dlatego nie będzie mógł subskrybować DesignerCreated zdarzenia.

Do obsługi tego problemu, w każdym przypadku, gdy jest tworzony wszelkie powierzchnie projektu lub Projektant składnika Visual Studio środowisko tworzy wystąpienia zarejestrowanych DesignSurfaceExtension i zastosowanie powierzchni utworzone lub składnika.

Gwarantuje to, że projektant uruchamiania modyfikacji VSPackage, są właściwie wykonane i VSPackage, sam jest ładowany w razie potrzeby.

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.