İzlenecek yol: bir sihirbaz oluşturma

Makale
02/25/2013

Sihirbazlar, gibi Add-in Wizard, karmaşık, yinelenen veya zor bir görevi gerçekleştirmek için bir dizi eylem yoluyla bir kullanıcıya müşteri adayı programlardır. Örneğin, kullandığı sihirbazlar, ağ kaynaklarına bağlanmak için Windows yazıcılara bağlanmak vb..

De Visual Studio, sihirbazlar genellikle bir dizi bir kullanıcıdan giriş isteyen soru sormak ve sonuçları kodu oluşturmak için kullanın. Sihirbazlar, ancak her zaman bir kullanıcı arabirimi (UI) görüntülenmez. Görünmez arka planda kodunu üretmek için programlanabilir.

Üç farklı türde sihirbazları vardır.

Yeni Project sihirbazları — adı da anlaşılacağı gibi bu sihirbazlardaki belirli türde bir proje, yeni kod üretmek için kullanıcı, kendi kod eklemek bir başlangıç noktası vererek kullanılır. Bu sihirbaz en yaygın kullanılan türüdür.
Add New Item sihirbazı — Bu sihirbazlar bir projeye Web formları, metin dosyaları, html sayfaları, xml sayfaları ve diğerleri, gibi yeni öğeler eklemek için kullanılır.
Özel sihirbazlar— Bu sihirbazlar iletişim kutusundan adı verilen değil. Bunun yerine, doğrudan eklentiler, makrolar veya başka türde bir kod denir. Bunlar olabilir veya bir kullanıcı Arabirimi görüntülenmeyebilir. Her iki durumda da, bunlar kodu oluşturur. Bu tür bir sihirbaz kullanılan genellikle en az.

Sihirbaz türü ne olursa olsun, hepsinin ortak nitelikler vardır.

Kullanılırlar.net nesneleri saðlamanýzý IDTWizard arabirim ve ilişkili bir yöntem olan Execute, Sihirbazı'nı çalıştırmak istediğiniz kodu içerir.
Tüm bir .vsz dosyasının içinde kendilerini görüntülemek için kullandıkları Visual Studio.
Bunlar, tüm kod oluşturun veya başka bir görev gerçekleştirmek.

Oluşturduğunuz sihirbazların öğelerin görünümünü özelleştirebilirsiniz. Sihirbazlar, çoğunlukla bir veya daha fazla windows veya sayfaları oluşur. Sayfaları içerebilir açıklayıcı bir görüntü gibi üst veya sol tarafına sayfa, etiket açıklamasını, yönergeler ve bir alanda hangi Gezinti denetimleri gibi İleri ve önceki yerleştirilebilir.

Sihirbazlarda oluşturma işlemi Visual C++ standart oluşturma biraz farklı Visual Studio sihirbazlar. Sihirbazlar için hedeflenen oluşturma hakkında ek bilgi için Visual C++, bkz: Bir sihirbaz tasarlama ve Bir Custom sihirbaz oluşturma.

Not

Gördüğünüz iletişim kutuları ve menü komutları, etkin ayarlarınıza ve ürün sürümüne bağlı olarak Yardım menüsünde açıklanana göre farklılık gösterebilir.Bu yordamlar, genel geliştirme ayarları ile etkin geliştirilmiştir.Ayarlarınızı değiştirmek için Al ve Verayarları üzerinde araçları menü.Daha fazla bilgi için bkz. Visual Studio ayarları.

Temel bir sihirbaz örneği

Visual Studio eklenti Sihirbazı

Bu resmi bir panelini gösterir Add-In Wizard, bir eklenti oluşturmak için adımları bir dizi aracılığıyla müşteri adayları Sihirbazı yeni bir proje türü. Sizin sihirbazlar görünümünü özelleştirebilirsiniz ama Add-In Wizard Sihirbazı standart bir tür stil iyi bir örnektir. Tamamlanan sihirbazlar kullanılabilir şablonlar haline Yeni bir proje veya Add New Item iletişim kutuları.

Temel bir sihirbaz oluşturma ve isteğe bağlı olarak özel bir simge verin göstermektedir.

Visual Basic ve Visual C# içinde temel bir sihirbaz oluşturmak için

Çalışan Visual Studio bir yönetici. Kayıt Sihirbazı, bu ayrıcalığı gerekli şekilde kayıt defteri güncelleştirilmesini gerektirir.
MyNewWizard adlı yeni bir Class Library projesi oluşturun.
Başvuru Ekle EnvDTE ve EnvDTE80 projesi.

Bunu yapmak için projeyi sağ tıklatın ve Add Reference. İçinde.net sekme Add Reference iletişim, EnvDTE ve EnvDTE80'ı ve ardından Tamam.

Sınıf modülünde yapılan başvuruları dahil EnvDTE ve EnvDTE80 ve IDTWizard arabirimi. Bu Visual C# , örnek bir başvuru da eklemeniz gerekir System.Windows.Forms ve 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
    {
    }
}

Eklediğinizde, Implements ifadesine Visual Basic, imleci satırın sonuna yerleştirin ve enter tuşuna basarak otomatik olarak oluşturmak bir Execute yöntemi yordam. İçin Visual C#, ancak sizin eklemeniz gerekir Execute yordam el ile:

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

Ekleme Sihirbazı'nı çalıştırmak için istediğiniz kodu Execute yordam. Bu örnekte, biz yalnızca basit ileti kutusu ekleyeceksiniz.

Aşağıdaki olması gerekir:

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 Sihirbazı başlatıldığında, yordamı çağırılır.

Projenize sağ Solution Explorer tıklatıp özellikleri açmak için Proje Özellikleri sayfasında,'ı tıklatın oluşturmak sekmesini tıklatın ve daha sonra iade com birlikte çalışabilirlik için kaydolun altındaki sayfa kutusunda.
N AssemblyInfo.cs dosyasında ComVisible özniteliği ve true olarak ayarlayın.
Tıklatarak sınıf kitaplığı dll oluşturmak için projeyi derleyin Build Solution , Build menü.
MyNewWizard.vsz adındaki sihirbazın .vsz metin dosyası oluşturun.

Bunu yapmak için şu adresteki biri gibi varolan bir .vsz dosyasının bir kopyasını yapmak < Visual Studio yükleme dizini >\VC#\CSharpProjectItems\Windows formlar ve, "MyNewWizard.vsz" olarak yeniden adlandırın.

.Vsz dosyasını sağlayan bir metin dosyasıdır Visual Studio sihirbaz tanımak ve içinde görüntülemek için Yeni bir proje veya Add New Item iletişim kutuları. Wizard Projenin ProgID (Project.Classname) veya GUID parametresi ayarlanmalıdır. Daha fazla bilgi için bkz. Yapılandırma.Sihirbazı başlatmak için Vsz dosyaları.

Not

İsteğe bağlı olarak, sihirbaz için bir VSDir dosyası da oluşturabilirsiniz.Bu Sihirbazı'nda bir açıklama olarak görüntüler bilgileri içeren EkleYeni bir proje veya EkleYeni dosya iletişim kutuları.Ayrıca bir simge belirtin ve listedeki konumunu düzenlemek sağlar.Daha fazla bilgi için bkz. Sihirbazlara ekleme madde ve yeni proje iletişim kutularını kullanarak ekleyin.Vsdir dosyaları.

MyNewWizard.vsz içeriğini aşağıdakiyle Değiştir:

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

Sihirbazın görüntülenmesini istediğiniz dizinde yeni .vsz dosyasını kaydedin.

Bu örnek için sihirbazın görünmesini istiyoruz Add New Item iletişim kutusunu Visual Basic projeleri, bu nedenle aşağıdaki dizinde .vsz dosyasını kaydedin: < Visual Studio yükleme dizini >\VB\VBProjectItems.
Çıkış Visual Studio ve sonra yeniden başlatın.

Bu zorlar Visual Studio yeni .vsz dosyası okunamıyor.
Yeni bir oluşturmak Visual Basic Windows Application projesi gibi bir proje.
Proje sağ tıklatın, üzerine EkleMaddeve ardından New Item.

Yeni sihirbaz (MyNewWizard) olarak görmelisiniz Yeni öğe ekleme iletişim kutusu.
Sihirbazı'nı tıklatın ve tıklatın Ekle düğme.

İletiyi görmek için "Sihirbaz şimdi çalışıyor."

Yeni sihirbaz için özel bir simge görüntülemek için

.Dll dosyası olarak aynı temel dosya adıyla ancak .ico uzantılı bir simge dosyası Sihirbazı dosyasıyla aynı dizine yerleştirin.

Örneğin, sihirbaz MyNewWizard.dll olarak adlandırılırsa, .ico dosyası MyNewWizard.ico olarak adlandırın.

-veya-
VSDir dosyası oluşturduysanız, orada simge (.ico) dosyasının yolunu belirtin.

Ayrıca bkz.

Aracılığıyla paylaş

İzlenecek yol: bir sihirbaz oluşturma

Temel bir sihirbaz örneği

Visual Basic ve Visual C# içinde temel bir sihirbaz oluşturmak için

Yeni sihirbaz için özel bir simge görüntülemek için

Ayrıca bkz.

Görevler

Başvuru

Kavramlar

Diğer Kaynaklar

Ek kaynaklar