Instruktaż: Tworzenie kreatora

Artykuł
03/12/2013

Kreatorzy, takich jak kreatora Add-in, to programy, które prowadzi użytkownika przez szereg działań do wykonania zadań złożonych, powtarzających się lub trudne.Windows, na przykład zastosowań kreatorów, aby połączyć się z zasobów sieciowych, łączenie się z drukarkami itd.

W Visual Studio, kreatorów ogólnie poprosić szereg pytań gromadzące dane wejściowe od użytkownika, a następnie wyniki do generowania kodu.Kreatorzy, jednak nie zawsze wyświetlaj interfejsu użytkownika (UI).One mogą zostać zaprogramowane w sposób niewidoczny wygenerować kodu w tle.

Istnieją trzy różne typy kreatorów.

Nowe kreatory projektu — jak wskazuje nazwa, tych kreatorów są używane do generowania nowego kodu dla określonego typu projektu, podając punkt początkowy, od którego należy dodać własne kod użytkownika.Jest to najczęściej używany typ kreatora.
Dodaj nowy element kreatorów — tych kreatorów są używane do dodawania nowych elementów, takich jak sieci Web formularze, pliki tekstowe, HTML stron, strony XML i tak dalej do projektu.
Kreatorzy niestandardowe— te kreatorzy nie są nazywane z okna dialogowego.Zamiast tego są one wywoływane bezpośrednio z dodatków, makra lub inne typy kodu.Mogą lub nie mogą być wyświetlane interfejsu użytkownika.W obu przypadkach generują kod.Ten typ kreatora jest używany często co najmniej.

Niezależnie od typu kreatora wszystkie one mają wspólne cechy.

Są one.NET obiekty wdrożenie tego IDTWizard interfejs i ma skojarzony metody, Execute, który zawiera kod, aby uruchomić Kreator.
Wszyscy korzystają z pliku .vsz do wyświetlania samych w Visual Studio.
One wszystkie generowanie kodu lub wykonywać niektóre inne zadania.

Można dostosować wygląd elementów w kreatorach, które można utworzyć.Kreatorzy najczęściej składają się z jednego lub więcej okien lub stron.Strony mogą zawierać opisowe obrazu, takie jak na górze lub po lewej stronie strony, opis etykiety, instrukcje i obszar, w których formanty nawigacji takich jak Dalej i Poprzedni mogą być umieszczane.

Proces tworzenia kreatorów w Visual C++ nieco różni się od tworzenia standard Visual Studio kreatorów.Aby uzyskać dodatkowe informacje dotyczące tworzenia kreatorów skierowane do Visual C++, zobacz Projektowanie Kreatora i Tworzenie kreatora niestandardowych.

[!UWAGA]

Okien dialogowych i poleceń menu, którą widzisz mogą różnić się od tych opisanych w pomocy, w zależności od tego, aktywne ustawienia lub edition.Procedury te zostały opracowane z ogólnych ustawień rozwoju aktywnych.Aby zmienić ustawienia, wybierz polecenie przywóz i wywózUstawienia na Narzędzia menu.Aby uzyskać więcej informacji, zobacz Visual Studio, ustawienia.

Przykładem kreatora podstawowe

Dodawanie programu Visual Studio w Kreatorze

Na ilustracji poniżej przedstawiono panelu z Kreatora Add-In, wpisz nowy projekt kreatora, który poprowadzi Cię przez szereg czynności, aby utworzyć Dodaj w.Można dostosować wygląd programu kreatorów, ale Kreatora Add-In jest dobrym przykładem styl standardowy typ kreatora.Kreatorzy wypełnione stają się dostępne szablony w Nowy projekt lub Dodaj nowy element okien dialogowych.

Następujące demonstruje, jak utworzyć podstawowe kreatora i opcjonalnie nadaj ikonę niestandardową.

Aby utworzyć kreatora podstawowego w języku Visual Basic i Visual C#

Uruchom Visual Studio jako Administrator.Kreator rejestracji wymaga aktualizacji rejestru, dlatego potrzebuje ten przywilej.
Utwórz nowy projekt biblioteki klasy o nazwie MyNewWizard.
Dodaj odwołania do EnvDTE i EnvDTE80 do projektu.

Aby to zrobić, kliknij prawym przyciskiem myszy projekt i kliknij przycisk Dodaj odwołanie.W.Na karcie netto Dodaj odwołanie okno dialogowe, kliknij EnvDTE i EnvDTE80, a następnie kliknij przycisk OK.

W module klasy zawierają odwołania do EnvDTE i EnvDTE80 i wprowadzenia w życie IDTWizard interfejsu.W tym Visual C# przykład, należy również dodać odwołanie do System.Windows.Forms i System.Runtime.InteropServices.

Imports EnvDTE
Imports EnvDTE80
Public Class Class1
    Implements IDTWizard

using System;
using System.Collections.Generic;
using System.Text;
using EnvDTE;
using EnvDTE80;
using System. Windows.Forms;

using System.Runtime.InteropServices;

namespace MyNewWizard
{

[ComVisible(true)]

[Guid("20184B81-7C38-4E02-A1E3-8D564EEC2D25"),

ProgId("MyNewWizard.Class1")]

    public class Class1 : IDTWizard
    {
    }
}

Po dodaniu Implements instrukcji do Visual Basic, umieść kursor na koniec wiersza i naciśnij klawisz enter, aby automatycznie utworzyć Execute metoda procedury.Dla Visual C#, jednak należy dodać Execute procedury ręcznie:

public class Class1 : IDTWizard
    {
    public void Execute(object Application, 
        int hwndOwner, ref object[] contextParams, 
        ref object[] customParams, 
        ref EnvDTE.wizardResult retval)

Dodaj kod ma kreatora Aby uruchomić Execute procedury.Na przykład firma Microsoft będzie wystarczy dodać proste okno komunikatu.

Powinien mieć następujące czynności:

Imports EnvDTE
Imports EnvDTE80

Public Class Class1
    Implements IDTWizard

    Public Sub Execute(ByVal Application As Object, ByVal _
    hwndOwner As Integer, ByRef ContextParams() As Object, ByRef _
    CustomParams() As Object, ByRef retval As EnvDTE.wizardResult) _
    Implements EnvDTE.IDTWizard.Execute
        MsgBox("The wizard is now running.")
    End Sub
End Class

using System.Text;
using EnvDTE;
using EnvDTE80;
using System.Windows.Forms;
using System.Runtime.InteropServices;

namespace MyNewWizardCS
{
    public class Class1 : IDTWizard
    {

    public void Execute(object Application, 
        int hwndOwner, ref object[] contextParams, 
        ref object[] customParams, 
        ref EnvDTE.wizardResult retval)
    {
        MessageBox.Show("The wizard is now running.");
    }
}

}

Execute Procedura jest wywoływane, gdy jest uruchamiany Kreator.

Kliknij prawym przyciskiem myszy projekt w Solution Explorer i kliknij przycisk Właściwości otworzyć Właściwości projektu strony, kliknij przycisk budować tab, a następnie sprawdź zarejestrować do współdziałania z modelem COM polu u dołu strony.
W pliku AssemblyInfo.cs ComVisible atrybutu i ustawiona wartość true.
Utwórz projekt, aby utworzyć klasy biblioteki dll, klikając Roztwór budować na budować menu.
Utwórz plik tekstowy .vsz dla kreatora o nazwie MyNewWizard.vsz.

Aby to zrobić, należy utworzyć kopię istniejącego pliku .vsz, takie jak te znajdujące się na < Visual Studio zainstalować katalog >formy \VC#\CSharpProjectItems\Windows i zmień jego nazwę na "MyNewWizard.vsz".

Plik .vsz jest plik tekstowy, który umożliwia Visual Studio do rozpoznania kreatora i wyświetlić go w Nowy projekt lub Dodaj nowy element okien dialogowych.Wizard Parametr powinien być ustawiony na progID (Project.Classname) projektu lub identyfikator GUID.Aby uzyskać więcej informacji, zobacz Konfigurowanie.Pliki Vsz, aby uruchomić kreatorów.

[!UWAGA]

Opcjonalnie można także utworzyć plik VSDir dla kreatora.Ten zawiera informacje, które są wyświetlane jako opis dla kreatora w DodajNowy projekt lub DodajNowy plik okien dialogowych.Umożliwia także określenie ikony i Rozmieść jego położenia na liście.Aby uzyskać więcej informacji, zobacz Dodawanie kreatorów, aby dodać element i okno dialogowe Nowy projekt przy użyciu.Pliki Vsdir.

Zamień zawartość MyNewWizard.vsz z następujących czynności:

VSWizard 7.0
Wizard=MyNewWizard.Class1
Param=First Item
Param=Second Item

Zapisz nowy plik .vsz w katalogu, gdzie chcesz kreatora są wyświetlane.

W tym przykładzie chcemy kreatora Aby pojawiają się w Dodaj nowy element okno dialogowe dla Visual Basic projektów, więc Zapisz plik .vsz w następującym katalogu: < Visual Studio zainstalować katalog >\VB\VBProjectItems.
Zakończ Visual Studio i uruchom go ponownie.

Zmusza to Visual Studio do odczytu nowy plik .vsz.
Utwórz nowy Visual Basic projektu, takie jak projekt aplikacji systemu Windows.
Kliknij prawym przyciskiem myszy projekt, wskaż polecenie Dodajelementu, a następnie kliknij przycisk Nowego elementu.

Powinieneś zobaczyć Twój nowy Kreator (MyNewWizard) w Dodać nowe elementy okno dialogowe.
Kliknij przycisk kreatora, a następnie kliknij przycisk Dodaj przycisku.

Zostanie wyświetlony komunikat, "Kreator jest teraz aktywna."

Aby wyświetlić ikonę niestandardową dla nowego Kreatora

Umieść plik ikony, o tej samej nazwie podstawowej pliku jako pliku .dll, ale z rozszerzeniem .ico w tym samym katalogu co plik kreatora.

Na przykład jeśli kreator ma nazwę MyNewWizard.dll, nazwę pliku .ico MyNewWizard.ico.

- lub -
Jeśli utworzono plik VSDir, należy określić ścieżkę w pliku ikony (.ico).

Zobacz też

Udostępnij za pośrednictwem

Instruktaż: Tworzenie kreatora

Przykładem kreatora podstawowe

Aby utworzyć kreatora podstawowego w języku Visual Basic i Visual C#

Aby wyświetlić ikonę niestandardową dla nowego Kreatora

Zobacz też

Zadania

Informacje

Koncepcje

Inne zasoby

Dodatkowe zasoby