Makale numaras�: 302896 - Son G�zden Ge�irme: 25 Aral�k 2006 Pazartesi - G�zden ge�irme: 11.3

Bir Office COM Add-in Visual Basic .NET kullanarak �retme

�ngilizce ve T�rk�e'yi yan yana g�r�nt�leme

Buraya t�klayarak �ngilizce ve T�rk�e'yi yan yana g�r�nt�leyebilirsiniz.

Otomatik terc�me makalelerin ne oldu�unu a��klayan yaz�y� okumak i�in buraya t�klay�n

Bu makalenin ge�erli oldu�u �r�nleri g�r�n.

Sistem �pucuBu makale, kulland��n�zdan farkl� bir i�letim sistemine y�neliktir. Sizinle ilgili olmayabilecek makale i�eri�i devre d�� b�rak�ld�.

Microsoft Office 2000 ve sonraki uygulama eklentileri geli�tirmek ve Office uygulamalar�n� denetlemek i�in olu�turmak i�in bir yeni, tutarl� bir tasar�m mimarisini destekler. Bu eklentiler, COM eklentilerini olarak adland�r�l�r. Bu ad�m ad�m makalede, Office COM eklentileri a��klan�r ve bir Office COM nas�l a��klar eklenti Microsoft Visual Basic .NET kullanarak.

�ste

IDTExensibility2 arabirimi

Bir COM eklentisi bir i�lem i�i COM sunucusu ya da Microsoft Add-in Tasar�mc�s� T�r kitapl��nda (Msaddndr.dll) a��kland�� gibi IDTExensibility2 arabirimini uygulayan ActiveX dinamik ba�lant� kitapl�� (DLL) olur. T�m COM eklentilerini Bu arabirimden devral�r ve her be� y�ntemlerinden biri uygulamal�d�r.

OnConnection

COM eklentisini ba�l� her OnConnection olay� harekete. Eklentiyi ba�latma s�ras�nda son kullan�c� taraf�ndan ya da Otomasyon yoluyla ba�l� olabilir. OnConnection ba�ar�yla d�nerse, eklentinin y�klenmesi denir. Bir hata iletisi d�nd�rd�, ana uygulama eklenti i�in ba�vuru hemen serbest b�rak�r ve nesne yok edilir.

OnConnection a�a��daki d�rt parametre yer al�r:

Uygulama - BIR ana uygulama nesnesine ba�vuru.
ConnectMode - eklentinin nas�l ba�lanaca��n� belirleyen BIR sabit. Eklenti a�a��daki yollarla ba�lanabilir:
- ext_cm_AfterStartup - eklenti <a0>COM eklentileri</a0> ileti�im kutusundan son kullan�c� taraf�ndan ba�lat�ld�.
- komut sat�r�ndan ext_cm_CommandLine - eklenti ba�land�. Bu Office uygulamalar� i�in COM eklentileri olu�turma i�in ge�erli de�ildir not al�n.
- Otomasyon yoluyla bir d�� uygulama taraf�ndan ext_cm_External - eklenti ba�land�. Bu Office i�in COM eklentileri olu�turma i�in ge�erli de�ildir Not uygulamalar�.
- ext_cm_Startup - eklenti, uygulaman�n ba�lang�c�nda ana makinesi taraf�ndan ba�lat�ld�. Bu davran��, kay�t defterindeki bir ayar taraf�ndan denetlenir.
AddInInst - bu eklenti ana bilgisayar uygulamas�n�n <a1>COM eklentileri</a1> koleksiyonunda ba�vurdu�u COMAddIn nesnesine BIR ba�vuru.
�zel - bir kullan�c� tan�ml� veri saklayabilen bir Variant t�r� de�erleri dizisi.

OnDisconnection

COM eklentisini kesildi�inde ve yaln�zca bu belle�i kald�r�r �nce OnDisconnection olay� harekete. Eklenti herhangi bir temizleme kaynaklar�n bu durumda �al��mal�d�r ve ana uygulamaya yap�lan de�i�iklikleri geri y�klemelisiniz.

OnDisconnection a�a��daki iki parametre al�r:

RemoveMode - eklentinin nas�l kesildi belirten BIR sabit. Eklenti a�a��daki yollarla kesilebilir:
- ana uygulama kapat�ld��nda ext_dm_HostShutdown - eklenti ba�lant�s� kesildi.
- ext_dm_UserClosed - eklenti-, son kullan�c� ya da bir Otomasyon ba�lant�s� kesildi denetleyicisi.
�zel - bir kullan�c� tan�ml� veri saklayabilen bir Variant t�r� de�erleri dizisi.

Onadd�nsupdate

K�mesini COM kaydolurken Onadd�nsupdate olay� harekete eklentileri de�i�iklikleri. Her bir COM eklentisi y�klenmi� veya ana bilgisayar uygulamadan kald�r�ld�, ba�ka bir deyi�le, bu olay harekete.

OnStartupComplete ve OnBeginShutdown

Hem ana bilgisayar uygulamas�n�n ayr�ld� veya y�kleme ya da kendisi bellekten kald�r�lmas� uygulama me�gul oldu�undan kullan�c� etkile�imi ka��n�lmal�d�r bir duruma girerken OnStartupComplete ve OnBeginShutdown y�ntemleri olarak adland�r�l�r. Eklenti ba�lat�l�rken ba�land� ve ana bilgisayar kapatma s�ras�nda eklentinin keser OnBeginShutdown yaln�zca adland�r�l�r, OnStartupComplete yaln�zca denir.

Bu olaylar ba?latmak i�in kullan�c� arabirimi i�in ana bilgisayar uygulamas�n�n tam etkin oldu�undan, aksi durumda OnConnection ve OnDisconnection kullan�lamaz olacak belirli eylemleri ger�ekle�tirmek i�in tek yol olabilirler.

�ste

COM eklentisi, kay�t

Normal COM kay�t ek olarak, bir COM eklentisi kendisi i�inde �al��an her Office uygulamas� ile kaydetmeniz gerekir. Kendisini, belirli bir uygulama ile kaydetmek i�in <a0></a0>, eklenti, Prog�d anahtar�n�n alt�nda a�a��da belirtilen konumda, ad� kullanarak bir alt anahtar� olu�turman�z gerekir:

HKEY_CURRENT_USER\Software\Microsoft\Office\ OfficeApp \Addins\ ProgID

Eklenti kolay g�r�nen ad hem de tam bir a��klamas� i�in anahtar bu konumda bir de�er sa�lar. Buna ek olarak, eklentiyi istenen y�kleme davran��

LoadBehavior

adl� bir DWORD de�eri'ni kullanarak belirtmeniz gerekir. Bu de�er, nas�l eklenti ana bilgisayar uygulamas� taraf�ndan y�klenir ve a�a��daki de�erlerin birle�imini yap�lan belirler:

0 Ba�lant�y� Kes'i = - y�kl� de�il.
1 Ba�l� = - y�klenen.
2 Bootload - uygulama ba�lang��ta y�kle =.
8 - DemandLoad kullan�c� taraf�ndan istendi�inde y�kle =.
16 - ConnectFirstTime yaln�zca bir kez (ba�lang��ta sonraki) y�k =.

Belirtilen normal 0x03 de�eridir (ba�l� | Bootload).

Ayr�ca, �dtextensibility2 uygulayan eklentileri eklentileri desteklemeyen bir kullan�c� arabirimi, operasyonlar i�in g�venli olup olmad��n� belirtmek i�in

CommandLineSafe

adl� bir DWORD de�eri belirtmeniz gerekir. Yanl�� 0x00 de�eri g�sterir; true de�erini 0x01 g�sterir.

�ste

Visual Basic .NET kullanarak COM eklentisi olu�turma hakk�nda

Office COM eklenti daha �nce belirtildi�i gibi bir i�lem i�i COM oldu�u sunucu COM �al��t�rma katman� �zerinden bir Office uygulamas� taraf�ndan etkinle�tirildi. Bu nedenle, bir COM add-in Visual Basic. NET'te geli�tirme eklenti bile�eni. NET'te uygulanan ve sonra COM istemcileri i�in a��k olmas�n� gerektirir (di�er bir deyi�le, Office uygulamalar�n�n) �zerinden COM birlikte �al��abilirlik katman�.

Bir COM eklentisi, Visual Basic. NET'te olu�turmak i�in a�a��daki ad�mlar� izleyin:

Visual Basic. NET'te bir s�n�f kitapl�� olu�turma proje.
�dtextensibility2 uygulayan t�r�ndeki kitapl��a bir ba�vuru ekleyin. Bu bir ana birlikte �al��ma derlemesi zaten Extensibility ad�yla edinilebilir.
Microsoft Office nesne kitapl��na bir ba�vuru ekleyin. Bu bir ana birlikte �al��ma derlemesi zaten Office ad�yla edinilebilir.
Ortak bir s�n�f i�inde �dtextensibility2 uygulayan s�n�f kitapl�� olu�turun.
Sonra s�n�f kitapl�� yerle�ik olarak bulunur, bu kitapl�k COM birlikte �al��ma i�in kaydolun. Bunu yapmak i�in <a0></a0>, COM birlikte �al��ma ile kaydetmek ve g��l� bir derlemesi i�in bu s�n�f kitapl�� adl� olu�turur. Regasm.exe, bir .NET bile�eni, COM birlikte �al��ma i�in kaydetmek i�in kullanabilirsiniz.
Kay�t defteri girdilerini olu�turun, b�ylece Office uygulamalar� tan�mak ve eklenti y�klenemedi.

T�m bu ad�mlar� tamamlamak se�im yapabilirsiniz veya <a1>T�r</a1> Eklentisi payla��lan bir .NET projesi olu�turabilirsiniz. Bu,. NET'te bir COM eklentisini olu�turmaya yard�mc� geni�letilebilirlik Sihirbaz� ba�lar.

Geni�letilebilirlik Sihirbaz� ile birlikte bir Connect s�n�f �dtextensibility2 arabirimini uygulayan Visual Basic .NET s�n�f kitapl�� proje olu�turur. Bo� IDTExtensibility �yeleri uygulayan skeleton kodunu da olu�turulur. Bu proje Extensibility ve Office birle�tirmeler i�in ba�vuru var. Proje olu�turma ayarlar�n�, se�ilen COM birlikte �al��ma i�in kayd� vard�r. Birle�tirme anahtar� (.snk) dosyas� olu�turulur ve Assemblyinfo.vb AssemblyKeyfile �zniteli�inde ba�vuruda bulunulan.

S�n�f kitapl�� birlikte proje, sihirbaz ba�ka bilgisayarlardaki COM eklentisini da��tmak i�in kullanabilece�iniz bir kurulum projesi olu�turur. Isterseniz, bu proje ��karabilirsiniz.

�ste

Ad�m ad�m �rnek

Microsoft Visual Studio. NET'te Dosya men�s�nden Yeni ' yi t�klat�n ve sonra Project ' i t�klat�n.
Yeni proje) ileti�im kutusunda, Di�er projelerProje t�rleri alt�nda) geni�letin, Extensibility Projects se�in ve sonra payla��lan eklenti �ablonu se�in.
MyCOMAddin eklenti yaz�n ve Tamam ' � t�klat�n.
Geni�letilebilirlik Sihirbaz� g�r�nt�lendi�inde, �u ad�mlar� izleyin:
1. Sayfa 1'de, bir eklenti olu�tur, Visual Basic kullanarak se�in ve ileri ' yi t�klat�n.
2. Sayfa 2, a�a��daki ana bilgisayar uygulamalar� se�in ve ileri ' yi t�klat�n:
  - Microsoft Word
  - Microsoft PowerPoint
  - Microsoft Outlook
  - Microsoft Excel
  - Microsoft Access
3. 3 Sayfa, ad ve a��klama i�in eklentinin girin ve ileri ' yi t�klat�n.
  
  NotCOM eklentisi ileti�im kutusunda Office uygulamas�nda ad�n� ve eklentinin a��klamas� g�r�nt�lenir.
4. Sayfa 4'de, t�m kullan�labilir olan se�enekleri se�in ve ileri ' yi t�klat�n.
5. Son ' u t�klat�n.
A�a��daki �ye Ba�lan s�n�f�na ekleyin:
Dim WithEvents MyButton As CommandBarButton

A�a��daki kodu �dtextensibility2Ba�lan s�n�f�ndaki t�m �yelerinin uygulamak:

    Public Sub OnBeginShutdown(ByRef custom As System.Array) Implements Extensibility.IDTExtensibility2.OnBeginShutdown
        On Error Resume Next
        ' Notify the user you are shutting down, and delete the button.
        MsgBox("Our custom Add-in is unloading.")
        MyButton.Delete()
        MyButton = Nothing

    End Sub

    Public Sub OnAddInsUpdate(ByRef custom As System.Array) Implements Extensibility.IDTExtensibility2.OnAddInsUpdate
        '
    End Sub

    Public Sub OnStartupComplete(ByRef custom As System.Array) Implements Extensibility.IDTExtensibility2.OnStartupComplete

        Dim oCommandBars As CommandBars
        Dim oStandardBar As CommandBar

        On Error Resume Next
        ' Set up a custom button on the "Standard" command bar.
        oCommandBars = applicationObject.CommandBars
        If oCommandBars Is Nothing Then
            ' Outlook has the CommandBars collection on the Explorer object.
            oCommandBars = applicationObject.ActiveExplorer.CommandBars
        End If

        oStandardBar = oCommandBars.Item("Standard")
        If oStandardBar Is Nothing Then
            ' Access names its main toolbar Database.

            oStandardBar = oCommandBars.Item("Database")

        End If

        ' In case the button was not deleted, use the exiting one.
        MyButton = oStandardBar.Controls.Item("My Custom Button")
        If MyButton Is Nothing Then

            MyButton = oStandardBar.Controls.Add(1)
            With MyButton
                .Caption = "My Custom Button"
                .Style = MsoButtonStyle.msoButtonCaption

                ' The following items are optional, but recommended. 
                ' The Tag property lets you quickly find the control 
                ' and helps MSO keep track of it when more than
                ' one application window is visible. The property is required
                ' by some Office applications and should be provided.

                .Tag = "My Custom Button"

                ' The OnAction property is optional but recommended. 
                ' It should be set to the ProgID of the add-in, so that if
                ' the add-in is not loaded when a user clicks the button,
                ' MSO loads the add-in automatically and then raises
                ' the Click event for the add-in to handle. 

                .OnAction = "!<MyCOMAddin.Connect>"

                .Visible = True
            End With
        End If

        ' Display a simple message to show which application you started in.
        MsgBox("Started in " & applicationObject.Name & ".")


        oStandardBar = Nothing
        oCommandBars = Nothing


    End Sub

    Public Sub OnDisconnection(ByVal RemoveMode As Extensibility.ext_DisconnectMode, ByRef custom As System.Array) Implements Extensibility.IDTExtensibility2.OnDisconnection

        On Error Resume Next
        If RemoveMode <> Extensibility.ext_DisconnectMode.ext_dm_HostShutdown Then _
           Call OnBeginShutdown(custom)

        applicationObject = Nothing


    End Sub

    Public Sub OnConnection(ByVal application As Object, ByVal connectMode As Extensibility.ext_ConnectMode, ByVal addInInst As Object, ByRef custom As System.Array) Implements Extensibility.IDTExtensibility2.OnConnection


        MsgBox("On Connection In MyAddin")
        applicationObject = application
        addInInstance = addInInst


        ' If you aren't in startup, manually call OnStartupComplete.
        If (connectMode <> Extensibility.ext_ConnectMode.ext_cm_Startup) Then _
           Call OnStartupComplete(custom)

    End Sub


    Private Sub MyButton_Click(ByVal Ctrl As Microsoft.Office.Core.CommandBarButton, ByRef CancelDefault As Boolean) Handles MyButton.Click
        MsgBox("Our CommandBar button was pressed!")
    End Sub

Olu�turmak ve bir COM eklentisini s�nay�n. Bunu yapmak i�in �u ad�mlar� izleyin:
1. Yap�) men�s�nde, MyCOMAddin olu�tur) t�klat�n. COM eklentisi olu�turma kullan�lacak .NET s�n�f�n� COM birlikte �al��ma'ile kaydedece�ini unutmay�n.
2. Bir ana bilgisayar uygulamas� olarak, eklentiniz i�in (�rne�in, Microsoft Word veya Microsoft Excel) se�ili Office uygulamalar�ndan biri ba�lat�n.
3. Eklenti ba�lad�ktan sonra OnConnection olay� harekete ge�irilir ve bir ileti kutusu g�r�nt�lenir. Ne zaman OnStartupComplete olay� harekete ge�irilir, ileti kutusunu kapatmak ve ikinci bir ileti kutusu g�r�nt�lenir. Ileti kutusunu kapatmak.
4. Eklenti "My �zel d��me" ba�l��n� yeni bir �zel d��me ekledi�inizi, standart ara� �ubu�una unutmay�n.
5. Benim �zel d��mesini t�klat�n. D��meyi t�klatarak olay� eklenti taraf�ndan i�lenen ve bir ileti kutusu g�r�nt�lenir. Ileti kutusunu kapatmak.
6. Office uygulamas�'nden ��k�n.
7. Uygulaman�n OnBeginShutDown ��kt��n�zda olay ge�irilir ve bir ileti kutusu g�r�nt�lenir. Ileti kutusu g�steri sona erdirmek i�in iptal.

�ste

Referanslar

COM eklentileri yazma hakk�nda ek bilgi i�in Microsoft Knowledge Base'deki makaleyi g�r�nt�lemek �zere a�a��daki makale numaras�n� t�klat�n:

190253� (http://support.microsoft.com/kb/190253/EN-US/ ) BILGI: VB6 tasar�mc�lar� VB5'de �al��m�yor

Microsoft �nternet Explorer i�in Web tabanl� ��z�mler geli�tirme hakk�nda daha fazla bilgi i�in a�a��daki Microsoft Web sitelerini ziyaret edin:

http://msdn2.microsoft.com/en-us/ie/default.aspx (http://msdn2.microsoft.com/en-us/ie/default.aspx)

http://support.microsoft.com/iep (http://support.microsoft.com/iep)

�ste

Bu makaledeki bilginin uyguland�� durum:

Microsoft Visual Basic .NET 2002 Standard Edition
Microsoft Office Excel 2003
Microsoft Excel 2002 Standard Edition
Microsoft Office Outlook 2003
Microsoft Outlook 2002 Standard Edition
Microsoft Office PowerPoint 2003
Microsoft PowerPoint 2002 Standard Edition
Microsoft Office Word 2003
Microsoft Word 2002 Standard Edition

�ste

kbmt kbautomation kbhowtomaster KB302896 KbMttr

�ste

Otomatik Terc�me

�NEML�: Bu makale, bir ki�i taraf�ndan �evrilmek yerine, Microsoft makine-�evirisi yaz�l�m� ile �evrilmi�tir. Microsoft size hem ki�iler taraf�ndan �evrilmi�, hem de makine-�evrisi ile �evrilmi� makaleler sunar. B�ylelikle, bilgi bankam�zdaki t�m makalelere, kendi dilinizde ula�m�� olursunuz. Bununla birlikte, makine taraf�ndan �evrilmi� makaleler m�kemmel de�ildir. Bir yabanc�n�n sizin dilinizde konu�urken yapabilece�i hatalar gibi, makale; kelime da�arc��, s�z dizim kurallar� veya dil bilgisi a��s�ndan yanl��lar i�erebilir. Microsoft, i�eri�in yanl�� evrimi veya onun m��teri taraf�ndan kullan�m�ndan do�an; kusur, hata veya zarardan sorumlu de�ildir. Microsoft ayr�ca makine �evirisi yaz�l�m�n� s�k�a g�ncellemektedir.

Makalenin �ngilizcesi a�a��daki gibidir:302896� (http://support.microsoft.com/kb/302896/en-us/ )

�ste

Di�er Kaynaklar

Di�er Destek Siteleri

Topluluk

Hemen Yard�m Al

Destek Uzman�ndan; E-posta, �evrimi�i veya Telefonda Yard�m Al�n

Makale �evirileri

United States (English)

This site in other countries/regions:

Bir Office COM Add-in Visual Basic .NET kullanarak �retme

Bu Sayfada

�zet

IDTExensibility2 arabirimi

OnConnection

OnDisconnection

Onadd�nsupdate

OnStartupComplete ve OnBeginShutdown

COM eklentisi, kay�t

Visual Basic .NET kullanarak COM eklentisi olu�turma hakk�nda

Ad�m ad�m �rnek

Referanslar

Bu makaledeki bilginin uyguland�� durum:

Anahtar Kelimeler:�

Di�er Destek Siteleri

Topluluk

Hemen Yard�m Al

Makale �evirileri

�lgili Destek Merkezleri

This site in other countries/regions:

Bir Office COM Add-in Visual Basic .NET kullanarak �retme

Bu Sayfada

�zet

IDTExensibility2 arabirimi

OnConnection

OnDisconnection

Onadd�nsupdate

OnStartupComplete ve OnBeginShutdown

COM eklentisi, kay�t

Visual Basic .NET kullanarak COM eklentisi olu�turma hakk�nda

Ad�m ad�m �rnek

Referanslar

Bu makaledeki bilginin uyguland��� durum:

Anahtar Kelimeler:�

Di�er Destek Siteleri

Topluluk

Hemen Yard�m Al

Makale �evirileri

�lgili Destek Merkezleri

Bu makaledeki bilginin uyguland�� durum: