Solution3-Schnittstelle

Artikel
08/10/2011

Stellt alle Projekte und projektmappenweiten Eigenschaften in der integrierten Entwicklungsumgebung (IDE) dar. Hat Vorrang vor Solution und Solution2.

Namespace: EnvDTE90
Assembly: EnvDTE90 (in EnvDTE90.dll)

Syntax

'Declaration
<GuidAttribute("DF23915F-FDA3-4DD5-9CAA-2E1372C2BB16")> _
Public Interface Solution3 _
    Inherits Solution2

[GuidAttribute("DF23915F-FDA3-4DD5-9CAA-2E1372C2BB16")]
public interface Solution3 : Solution2

[GuidAttribute(L"DF23915F-FDA3-4DD5-9CAA-2E1372C2BB16")]
public interface class Solution3 : Solution2

[<GuidAttribute("DF23915F-FDA3-4DD5-9CAA-2E1372C2BB16")>]
type Solution3 =  
    interface
        interface Solution2
    end

public interface Solution3 extends Solution2

Der Solution3-Typ macht die folgenden Member verfügbar.

Eigenschaften

	Name	Beschreibung
	AddIns	(Von Solution2 geerbt.)
	AddIns	Ruft eine AddIns-Auflistung mit allen derzeit verfügbaren Add-Ins ab, die der Projektmappe zugeordnet sind.
	Count	(Von Solution2 geerbt.)
	Count	Ruft einen Wert ab, der die Anzahl der in der Projektmappe enthaltenen Objekte angibt.
	DTE	(Von Solution2 geerbt.)
	DTE	Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
	Extender[String]	(Von Solution2 geerbt.)
	Extender[String]	Ruft das angeforderte Extenderobjekt ab, falls es für dieses Objekt verfügbar ist.
	ExtenderCATID	(Von Solution2 geerbt.)
	ExtenderCATID	Ruft die ID der Extenderkategorie (CATID) für das Objekt ab.
	ExtenderNames	(Von Solution2 geerbt.)
	ExtenderNames	Ruft eine Liste der für das Objekt verfügbaren Extender ab.
	FileName	(Von Solution2 geerbt.)
	FileName	Infrastruktur. Ruft den Namen der Datei ab.
	FullName	(Von Solution2 geerbt.)
	FullName	Ruft den vollständigen Pfad und Namen der Objektdatei ab.
	Globals	(Von Solution2 geerbt.)
	Globals	Ruft das Globals-Objekt mit den Variablenwerten ab, die in der Projektmappendatei (.sln), in der Projektdatei oder in den Profildaten des Benutzers gespeichert werden können.
	IsDirty	(Von Solution2 geerbt.)
	IsDirty	Infrastruktur. Ermittelt, ob für die Projektmappe nicht gespeicherte Änderungen vorhanden sind.
	IsOpen	(Von Solution2 geerbt.)
	IsOpen	Ruft ab, ob eine Projektmappe geöffnet ist.
	Parent	(Von Solution2 geerbt.)
	Parent	Ruft das unmittelbar übergeordnete Objekt eines Solution2-Objekts ab.
	Projects	(Von Solution2 geerbt.)
	Projects	Ruft eine Auflistung aller Projekte ab, die sich derzeit in der Projektmappe befinden.
	Properties	(Von Solution2 geerbt.)
	Properties	Ruft eine Auflistung aller Eigenschaften des Solution2-Objekts ab.
	Saved	(Von Solution2 geerbt.)
	Saved	Ruft einen Wert ab, der angibt, ob eine Projektmappe seit dem letzten Speichern oder Öffnen nicht geändert wurde, oder legt diesen Wert fest.
	SolutionBuild	(Von Solution2 geerbt.)
	SolutionBuild	Ruft das SolutionBuild-Objekt für die Projektmappe ab, das den Stamm des Buildautomatisierungsmodells auf Projektmappenebene darstellt.
	TemplatePath[String]	(Von Solution2 geerbt.)
	TemplatePath[String]	Ersetzt durch GetProjectTemplate.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	AddFromFile(String, Boolean)	(Von Solution2 geerbt.)
	AddFromFile(String, Boolean)	Fügt basierend auf einer bereits im System gespeicherten Projektdatei ein Projekt zur Projektmappe hinzu.
	AddFromTemplate(String, String, String, Boolean)	(Von Solution2 geerbt.)
	AddFromTemplate(String, String, String, Boolean)	Kopiert eine vorhandene Projektdatei sowie alle darin enthaltenen Elemente oder Unterverzeichnisse in den angegebenen Pfad und fügt sie zur Projektmappe hinzu.
	AddSolutionFolder(String)	(Von Solution2 geerbt.)
	AddSolutionFolder(String)	Fügt einen Projektmappenordner einer ProjectItems-Auflistung hinzu.
	Close(Boolean)	(Von Solution2 geerbt.)
	Close(Boolean)	Schließt die aktuelle Projektmappe.
	Create(String, String)	(Von Solution2 geerbt.)
	Create(String, String)	Erstellt in dem angegebenen Verzeichnis eine leere Projektmappe mit dem festgelegten Namen.
	FindProjectItem(String)	(Von Solution2 geerbt.)
	FindProjectItem(String)	Findet ein Element in einem Projekt auf.
	GetEnumerator()	(Von Solution2 geerbt.)
	GetEnumerator()	Gibt eine Enumeration für Elemente in einer Auflistung zurück.
	GetProjectItemTemplate(String, String)	(Von Solution2 geerbt.)
	GetProjectItemTemplate(String, String)	Gibt einen Pfad zur angegebenen Projektelementvorlage zurück.
	GetProjectItemTemplates	Gibt eine Auflistung von Projektelementvorlagen für das angegebene Projekt zurück.
	GetProjectTemplate(String, String)	(Von Solution2 geerbt.)
	GetProjectTemplate(String, String)	Gibt einen Pfad zur angegebenen Projektvorlage zurück.
	Item(Object)	(Von Solution2 geerbt.)
	Item(Object)	Gibt einen indizierten Member einer Projects-Auflistung zurück.
	Open(String)	(Von Solution2 geerbt.)
	Open(String)	Öffnet eine angegebene Projektmappe.
	ProjectItemsTemplatePath(String)	(Von Solution2 geerbt.)
	ProjectItemsTemplatePath(String)	Ersetzt durch GetProjectItemTemplate.
	Remove(Project)	(Von Solution2 geerbt.)
	Remove(Project)	Entfernt das angegebene Projekt aus der Projektmappe.
	SaveAs(String)	(Von Solution2 geerbt.)
	SaveAs(String)	Speichert die Projektmappe.

Zum Seitenanfang

Hinweise

Das Solution3-Objekt ist eine Auflistung aller Projekte in der aktuellen Instanz der IDE und aller projektmappenweiten Eigenschaften, z. B. Buildkonfigurationen. Das Solution3-Objekt enthält unabhängig davon, ob es sich um ein umschlossenes Projekt, ein Unterprojekt oder ein Projekt auf oberster Ebene handelt, für jedes Projekt ein Projektelement.

Auf dieses Objekt können Sie mit DTE.Solution verweisen. Verwenden Sie Solution3.Item(EnvDTE.Constants.vsProjectKindMisc) oder Solution3.Item(EnvDTE.Constants.vsProjectKindSolutionItems), um auf virtuelle Projekte wie MiscFiles oder SolutionItems zu verweisen.

Beispiele

Informationen zum Ausführen des Add-In-Codes finden Sie unter Gewusst wie: Kompilieren und Ausführen der Codebeispiele für das Automatisierungsobjektmodell.

Public Sub OnConnection(ByVal application As Object, _
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    _applicationObject = CType(application, DTE2)
    _addInInstance = CType(addInInst, AddIn)
    Solution3Example(_applicationObject)
End Sub

Sub Solution3Example(ByVal dte As DTE2)
    ' This function creates a solution and adds a Visual C# Console
    ' project to it.
    Try
        Dim soln As Solution3 = CType(DTE.Solution, Solution3)
        Dim csTemplatePath As String
        ' This path must exist on your computer.
        ' Replace <file path> below with an actual path.
        Dim csPrjPath As String = "<file path>"
        MsgBox("starting")
        ' Get the project template path for a C# console project.
        csTemplatePath = CType(soln.GetProjectTemplate _
        ("ConsoleApplication.zip", "CSharp"), string)
        ' Create a new C# Console project using the template obtained 
        ' above.
        soln.AddFromTemplate(csTemplatePath, csPrjPath, _
        "New CSharp Console Project", False)
        MsgBox("done")
    Catch ex As System.Exception
        MsgBox(ex.ToString)
    End Try
End Sub

using System.Windows.Forms;
public void OnConnection(object application,
 Extensibility.ext_ConnectMode connectMode, object addInInst,
 ref System.Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    // Pass the applicationObject member variable to the code example.
    Solution3Example((DTE2)_applicationObject);
}

public void Solution3Example(DTE2 dte)
{
    // This function creates a solution and adds a Visual C# Console
    // project to it.
    try{
        Solution3 soln = (Solution3)_applicationObject.Solution;
        String csTemplatePath;
        // The file path must exist on your computer.
        // Replace <file path> below with an actual path.
        String csPrjPath = "<file path>";
        "<file path>MessageBox.Show("Starting...");
        "<file path>"<file path>csTemplatePath = 
        soln.GetProjectTemplate("ConsoleApplication.zip", "CSharp");
        // Create a new C# Console project using the template obtained 
        // above.
        soln.AddFromTemplate(csTemplatePath, csPrjPath,
          "New CSharp Console Project", false);
        MessageBox.Show("Done!");
    }
    catch(SystemException ex)
    {
        MessageBox.Show("ERROR: " + ex);
    }
}

Siehe auch

Referenz

EnvDTE90-Namespace

Freigeben über