Makale numaras�: 302902 - Son G�zden Ge�irme: 27 Mart 2007 Sal� - G�zden ge�irme: 7.4

Visual C# .NET ile Office otomasyon sunucular� i�in ba�lama

�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�.

Bir Microsoft Office gibi bir uygulaman�n hangi ko�ullarda otomatikle�tirmek uygulama, uygulama nesneleri baz� nesneleri �ekilde ba�lanmal�d�r arama �zellikleri ve y�ntemleri ofisinin. Ba�lanan �zellik ve y�ntem �a�r�lar� i�in bu �zellikleri ve y�ntemleri uygulayan nesnelerin i�lemi genellikle ba�lama olarak da adland�r�l�r. Visual C# ile kullan�labilen iki ba�laman�n erken ba�lama ve ge� ba�lama t�rleridir. Se�ti�iniz ba�lama t�r� program�n�z� ya�at�labilirlik performans� ve esnekli�i de dahil olmak �zere bir�ok y�n�n� etkileyebilir.

Bu makalede a��klar ve Visual C# Otomasyon istemcilerinin �nceki ve ge� ba�lama kar��la�t�r�r ve her iki t�rdeki ba�lama g�steren kod �rnekleri sa�lar.

�ste

Erken ba�lama

Erken ba�lama ile Visual C# hakk�nda Office do�rudan y�ntemleri veya �zellikleri kullanmas� gereken uygulama s�z konusu kullan�labilir t�r bilgileri kullan�r. Derleyici t�r� ger�ekle�tirebilir ve s�zdizimi do�ru numaray� ve parametre t�r� bir y�ntem veya �zellik ge�irildi ve d�nd�r�len de�er, beklenen t�rde olaca��n� denetler. Daha az �al��ma zaman�nda bir �zellik veya y�ntem �a�r�s� yapmak i�in gerekli oldu�undan, erken ba�lama bazen daha h�zl�, erken ba�lama daha h�zl� olabilir, ancak bununla birlikte, ge� ba�lamaya kar��la�t�r�ld��nda performans genellikle g�zard� g�ncelle�tirilece�idir.

Erken ba�lama k��k olumsuz yan�, olas� s�r�m uyumluluk sorunlar�na neden bulunmuyor. �rne�in, Microsoft Excel 2002 gibi bir Otomasyon sunucusu bir yeni bir y�ntem veya �zellik, Excel 2000'de ula��lam�yor ya da bir varolan bir �zelli�i veya y�ntemi i�in bir de�i�iklik yapar tan�t�r varsayal�m. Bu de�i�iklikler, nesnesinin ikili d�zenini de�i�tirmek ve Excel 2000 otomatikle�tirmek i�in Excel 2002 t�r bilgileri kullanan bir Visual C# uygulama sorunlara neden. Erken ba�lama ile ilgili bu sorunun olu�mamas� i�in <a0></a0>, genellikle t�r bilgileri geli�tirmek ve otomasyon istemciniz s�nama desteklemek istedi�iniz Office uygulamas�n�n en eski s�r�m� i�in kullanaca��n�z �nerilir.

A�a��daki ad�mlarda, erken ba�lama kullanan bir otomasyon istemci nas�l g�sterilmektedir. Ad�mlar� g�stermek gibi erken ba�lama, otomasyon istemci i�in t�r kitapl��na ba�vuru gerektirir, unutmay�n.

Erken ba�lama kullanan bir Otomasyon istemcisi olu�tur

Microsoft Visual Studio .NET'i ba�lat�n. Dosya men�s�nde Yeni'yi t�klat�n ve Project ' � t�klat�n. Visual C# Projects t�rlerinden Windows Application ' � se�in. Varsay�lan olarak, Form1 olu�turulur.
Microsoft Excel nesne kitapl�� ' na bir ba�vuru ekleyin. Bunu yapmak i�in �u ad�mlar� izleyin:
1. Proje) men�s�nde Add Reference ' � t�klat�n.
2. COM sekmesinde, Microsoft Excel nesne kitapl�� ' n� bulun ve Se� ' i t�klat�n.
  
  Not Office 2003 Primary �nterop Assemblies (P�a) i�erir. Office XP P�a i�ermez, ancak bunlar y�klenebilir. Office XP P�a 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:
  328912� (http://support.microsoft.com/kb/328912/ ) Microsoft Office XP ana birlikte �al��ma derlemeleri (PIA) kar��dan y�klenebilir
3. Se�imlerinizi kabul etmek i�in Tamam <a0>Ba�vuru Ekle</a0> ileti�im kutusunda t�klat�n. Se�ti�iniz kitapl�klar i�in sar?c?lar? olu�turmak isteyen bir ileti al�rsan�z, Evet ' i t�klat�n.
G�r�n�m men�s�nden ara� kutusunu g�r�nt�lemek i�in ara� se�in ve Form1'e bir d��me ekleyin.
Button1</a1> �ift t�klat�n. Formun kod penceresi g�r�nt�lenir.

Kod penceresinde a�a��daki kodu

private void button1_Click(object sender, System.EventArgs e)
{
}

ile:

private void button1_Click(object sender, System.EventArgs e)
{
	Excel.Application objApp;
	Excel._Workbook objBook;
	Excel.Workbooks objBooks;
	Excel.Sheets objSheets;
	Excel._Worksheet objSheet;
	Excel.Range range;

	try
	{
		// Instantiate Excel and start a new workbook.
		objApp = new Excel.Application();
		objBooks = objApp.Workbooks;
		objBook = objBooks.Add( Missing.Value );
		objSheets = objBook.Worksheets;
		objSheet = (Excel._Worksheet)objSheets.get_Item(1);

		range = objSheet.get_Range("A1", Missing.Value);

		range.set_Value(Missing.Value, "Hello, World!" );

		//Return control of Excel to the user.
		objApp.Visible = true;
		objApp.UserControl = true;
	}
	catch( Exception theException ) 
	{
		String errorMessage;
		errorMessage = "Error: ";
		errorMessage = String.Concat( errorMessage, theException.Message );
		errorMessage = String.Concat( errorMessage, " Line: " );
		errorMessage = String.Concat( errorMessage, theException.Source );

		MessageBox.Show( errorMessage, "Error" );
	}
}

<a0>Kod</a0> penceresinin en �st�ne gidin. Kullanma y�nergeleri listesinin sonuna a�a��daki sat�r� ekleyin:
using System.Reflection; using Excel = Microsoft.Office.Interop.Excel;

�ste

Ge� ba�lama

�zellik ve y�ntem �al��t�rma, nesnelere �a�r� erken ba�lama aksine, ge� ba�lama bekler. Bunu yapmak i�in <a0></a0>, hedef nesne �zel bir COM arabirimini uygulamal�d�r: �dispatch. Visual C hangi y�ntemleri ve �zellikleri destekledi�i ilgili nesne interrogate i�in # IDispatch::GetIDsOfNames y�ntemi sa�lar ve IDispatch::Invoke y�ntemi sonra Visual C bu y�ntemleri ve �zellikleri i�in # sa�lar. Bu bi�imde ge� ba�lama baz� erken ba�lama ile devredilen s�r�m ba��ml�l�klar� kald�rma avantaj� vard�r. Bununla birlikte, otomasyon kod b�t�nl�k denetimi derleme kald�rma yan? s?ra, y�ntemleri ve �zellikleri d�zeltmek i�in ipu�lar� sa�lar, �ntellisense �zellikleri sa�layan dezavantajlar� vard�r.

Ge� ba�lama Visual C# ile kullanmak i�in <a0></a0>, System.Type.InvokeMember y�ntemini kullan�n. Bu y�ntem, IDispatch::GetIDsOfNames ve IDispatch::Invoke Otomasyon sunucu y�ntemlerini ve �zelliklerini �a??r?r.

Ge� ba�lama kullanan bir Otomasyon istemcisi olu�tur

Microsoft Visual Studio .NET'i ba�lat�n. Dosya men�s�nde Yeni'yi t�klat�n ve Project ' � t�klat�n. Visual C# Projects t�rlerinden Windows Application ' � se�in. Varsay�lan olarak, Form1 olu�turulur.
G�r�n�m men�s�nden ara� kutusunu g�r�nt�lemek i�in ara� se�in ve Form1'e bir d��me ekleyin.
Button1</a1> �ift t�klat�n. Formun kod penceresi g�r�nt�lenir.

Kod penceresinde a�a��daki kodu

private void button1_Click(object sender, System.EventArgs e)
{
}

ile:

private void button1_Click(object sender, System.EventArgs e)
{
	object objApp_Late;
	object objBook_Late;
	object objBooks_Late;
	object objSheets_Late;
	object objSheet_Late;
	object objRange_Late;
	object[] Parameters;

	try
	{
		// Get the class type and instantiate Excel.
		Type objClassType; 
		objClassType = Type.GetTypeFromProgID("Excel.Application"); 
		objApp_Late = Activator.CreateInstance(objClassType);

		//Get the workbooks collection.
		objBooks_Late = objApp_Late.GetType().InvokeMember( "Workbooks", 
		BindingFlags.GetProperty, null, objApp_Late, null );

		//Add a new workbook.
		objBook_Late = objBooks_Late.GetType().InvokeMember( "Add", 
			BindingFlags.InvokeMethod, null, objBooks_Late, null );

		//Get the worksheets collection.
		objSheets_Late = objBook_Late.GetType().InvokeMember( "Worksheets",
			BindingFlags.GetProperty, null, objBook_Late, null );

		//Get the first worksheet.
		Parameters = new Object[1];
		Parameters[0] = 1;
		objSheet_Late = objSheets_Late.GetType().InvokeMember( "Item", 
			BindingFlags.GetProperty, null, objSheets_Late, Parameters );

		//Get a range object that contains cell A1.
		Parameters = new Object[2];
		Parameters[0] = "A1";
		Parameters[1] = Missing.Value;
		objRange_Late = objSheet_Late.GetType().InvokeMember( "Range",
			BindingFlags.GetProperty, null, objSheet_Late, Parameters );

		//Write "Hello, World!" in cell A1.
		Parameters = new Object[1];
		Parameters[0] = "Hello, World!";
		objRange_Late.GetType().InvokeMember( "Value", BindingFlags.SetProperty, 
			null, objRange_Late, Parameters );

		//Return control of Excel to the user.
		Parameters = new Object[1];
		Parameters[0] = true;
		objApp_Late.GetType().InvokeMember( "Visible", BindingFlags.SetProperty,
			null, objApp_Late, Parameters );
		objApp_Late.GetType().InvokeMember( "UserControl", BindingFlags.SetProperty,
			null, objApp_Late, Parameters );
	}
	catch( Exception theException ) 
	{
		String errorMessage;
		errorMessage = "Error: ";
		errorMessage = String.Concat( errorMessage, theException.Message );
		errorMessage = String.Concat( errorMessage, " Line: " );
		errorMessage = String.Concat( errorMessage, theException.Source );

		MessageBox.Show( errorMessage, "Error" );
	}
}

<a0>Kod</a0> penceresinin en �st�ne gidin. Kullanma y�nergeleri listesinin sonuna a�a��daki sat�r� ekleyin:
using System.Reflection;

�ste

Referanslar

Daha fazla bilgi i�in a�a��daki Microsoft Developer Network (MSDN) Web sitesini ziyaret edin:

Visual Studio ile Microsoft Office geli�tirme
http://msdn2.microsoft.com/en-us/library/aa188489(office.10).aspx (http://msdn2.microsoft.com/en-us/library/aa188489(office.10).aspx)

Ba�lama hakk�nda ek bilgi i�in Microsoft Knowledge Base'deki makaleleri g�r�nt�lemek �zere a�a��daki makale numaralar�n� t�klat�n:

245115� (http://support.microsoft.com/kb/245115/ ) Erken ba�lama ve ge� ba�lama Otomasyon kullanma

244167� (http://support.microsoft.com/kb/244167/ ) Birden �ok Office s�r�m� i�in Otomasyon istemcilerinin yazma

247579� (http://support.microsoft.com/kb/247579/ ) M�mk�n oldu�unda, Office uygulamalar�n� otomatikle�tirmek i�in DISPID ba�lama kullan�n.

�ste

Bu makaledeki bilginin uyguland�� durum:

Microsoft Visual C# .NET 2003 Standard Edition
Microsoft Visual C# .NET 2002 Standard Edition
Microsoft Office Access 2003
Microsoft Access 2002 Standard Edition
Microsoft Office Excel 2003
Microsoft Excel 2002 Standard Edition
Microsoft Office PowerPoint 2003
Microsoft PowerPoint 2002 Standard Edition
Microsoft Office Word 2003
Microsoft Word 2002 Standard Edition

�ste

kbmt kbpia kbautomation kbhowtomaster KB302902 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:302902� (http://support.microsoft.com/kb/302902/en-us/ )

�ste

This site in other countries/regions:

Visual C# .NET ile Office otomasyon sunucular� i�in ba�lama

Bu Sayfada

�zet

Erken ba�lama

Erken ba�lama kullanan bir Otomasyon istemcisi olu�tur

Ge� ba�lama

Ge� ba�lama kullanan bir Otomasyon istemcisi olu�tur

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:

Visual C# .NET ile Office otomasyon sunucular� i�in ba�lama

Bu Sayfada

�zet

Erken ba�lama

Erken ba�lama kullanan bir Otomasyon istemcisi olu�tur

Ge� ba�lama

Ge� ba�lama kullanan bir Otomasyon istemcisi olu�tur

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: