Makale numaras�: 309681 - Son G�zden Ge�irme: 01 Temmuz 2004 Per�embe - G�zden ge�irme: 3.4

Nas�l yap�l�r: GetOleDbSchemaTable ve Visual C# .NET kullanarak �ema bilgilerini al

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

Bu makalede, OleDbConnection nesnesinin GetOleDbSchemaTable y�ntemi ADO.NET veritaban� �ema bilgilerini almak i�in nas�l kullan�laca�� g�sterilmektedir. �ema bir veri kayna��nda veritabanlar� veya veri kayna��, tablolar ve g�r�n�mler bir veritaban�nda kullan�labilen kataloglar�n� yan� s�ra, vb. bulunan k�s�tlamalar bilgilerdir. �ema bilgileri bir tabloda birincil anahtar s�tunlar� ve otomatik numara alanlar� i�erir.

Bir SqlClient.SqlConnection nesne kulland��n�zda, y�ntem GetOleDbSchemaTable i�in e�de�er oldu�unu unutmay�n. .NET Data Provider "SQL Server sakl� yordamlar ve bilgilendirme g�r�n�mleri arac�l��yla arka u� �ema bilgilerini g�sterir. G�r�n�mler ve Microsoft SQL Server'� kullan�labilen sakl� yordamlar hakk�nda daha fazla bilgi i�in MSDN Kitapl��'nda Transact-SQL ba�vuru konusuna bak�n.

�ste

Gereksinimler

A�a��daki listede, gereksinim duyaca��n�z donan�m, yaz�l�m, a� altyap�s� ve hizmet paketleri �nerilmektedir:

Microsoft Windows 2000 Professional, Windows 2000 Server, Windows Server veya Windows NT 4.0 Server 2000 Advanced
Microsoft Visual Studio. NET'i

Bu makalede, a�a��daki konularda bilgi sahibi oldu�unuz varsay�lmaktad�r:

Visual Studio .NET
ADO.NET temelleri ve s�zdizimi

�ste

GetOleDbSchemaTable OleDbConnection nesnesinin y�ntemi

OLE DB .NET Data Provider, �ema bilgileri g�stermek i�in OleDbConnection nesnesinin GetOleDbSchemaTable y�ntemini kullan�r. GetOleDbSchemaTable �ema bilgilerle doldurulan bir DataTable ' � verir.

Ilk ba��ms�z de�i�ken GetOleDbSchemaTable, �ema parametresi, hangi �ema bilgileri (tablolar, s�tunlar ve birincil anahtarlar gibi) geri d�nmek i�in tan�mlayan OleDbSchemaGuid ba��ms�z de�i�ken var. Ikinci ba��ms�z de�i�ken bir nesne DataTable �emada d�nd�r�len sat�rlar� s�zmek i�in k�s�tlamalar� dizidir (�rne�in, tablo ad�n�, t�r�n�, sahibi ve /or �ema ile ilgili k�s�tlamalar belirtebilir).

OleDbSchemaGuid �yeler

OleDbSchemaGuid ba��ms�z de�i�keni, �ema tablosu GetOleDbSchemaTable y�ntemi t�r�n� belirtir. OleDbSchemaGuid �yeleri baz�lar� �unlard�r:

S�tunlar�
Yabanc� anahtarlar
Dizinler
Birincil anahtarlar�
Tablolar
G�r�n�mler

OleDbSchemaGuid �yeleri tam bir listesi i�in <a0>References</a0> b�l�m�ndeki "OleDbSchemaGuid �yeleri" Web sitesine bak�n.

S�n�rlamalar

Her biri i�in elde edilen DataTable, DataColumn kar��l�k gelen nesne s�zge� de�erler dizisi, k�s�tlamalar� var. OleDbSchemaGuid ba��ms�z de�i�keni ilgili k�s�tlamalar belirler. OleDbSchemaGuid bir tablo belirtti�inizde, �rne�in, dizi k�s�tlamalar� ��yledir:

{table_catalog, table_schema, table_name, table_type}

Kullan�labilir k�s�tlamalar� g�zden ge�irmek i�in a�a��daki Microsoft Web sitesini OleDbSchemaGuid �yelerden birini t�klat�n:

OleDbSchemaGuid �yeler
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfsystemdataoledboledbschemaguidmemberstopic.asp (http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfsystemdataoledboledbschemaguidmemberstopic.asp)

K�s�tlama dizideki de�erler ge�irdi�inizde, Visual C# .NET null anahtar i�in de�erler i�eren bir dizi ��elerini i�erir. �rne�in, tablo �emalar� almak istiyorsan�z, bu OleDbSchemaGuid.Tables kullan�n. Tablo se�ene�ini belirlerseniz, ancak bu da di�er adlar, e�anlaml�lar�, g�r�n�mler ve ilgili di�er nesneleri d�nd�r�r. Bu nedenle, tablolar hari� t�m nesneleri s�zmek istiyorsan�z, bir TABLO k�s�tlamas� i�in TABLE_TYPE kullan�n. Bu nesnelerde s�zme nedeniyle, null TABLE_CATALOG TABLE_SCHEMA ve TABLE_NAME i�in kullanabilirsiniz:

schemaTable = cn.GetOleDbSchemaTable(OleDbSchemaGuid.Tables, 
              new Object[] {null, null, null, "TABLE"});

D�nd�r�len DataTable

GetOleDbSchemaTable y�ntemi d�nd�r�r DataTableOleDbSchemaGuid t�r� ve s�n�rlama �l��t�n� kar��layan her nesne i�in bir sat�r vard�r. DataTable, her ek �ema bilgilerini OleDbSchemaGuid alan�n� temel alarak arkas�ndan bir s�n�rlama s�tun i�in s�tun vard�r.

�u kodu kullan�n, �rne�in, her sat�rda bir DataTable d�nd�r�len bir veritaban� tablosu olur:

schemaTable = cn.GetOleDbSchemaTable(OleDbSchemaGuid.Tables, 
              new Object[] {null, null, null, "TABLE"});

TABLE_GUID, A��KLAMA TABLE_PROPID DATE_CREATED ve DATE_MODIFIED ek �ema s�tunlara g�re gelir, s�n�rlama s�tunlar�n (TABLE_CATALOG TABLE_SCHEMA, TABLE_NAME, TABLE_TYPE), DataTable ' d�nd�r�len s�tunlar �unlard�r.

Bu s�tun adlar� (di�er bir deyi�le, alan tan�mlay�c�lar� TABLE_CATALOG TABLE_SCHEMA ve TABLE_NAME gibi) listesini edinmek i�in <a0></a0>, s�ral� konumunu s�tunlar� kullanabilirsiniz. S�f�r tabanl� s�tun dizi oldu�unu unutmay�n:

for (int i = 0; i < schemaTable.Columns.Count; i++) {
   Console.WriteLine(schemaTable.Columns[i].ToString());
}

her s�tundaki (di�er bir deyi�le ger�ek tablo adlar�, kategoriler, m��teriler ve �al��anlar gibi) edinmek i�in <a0></a0>, sat�r s�ral� konumunu ItemArray de kullanabilirsiniz. ItemArray s�f�r tabanl� oldu�unu unutmay�n:

for (int i = 0; i < schemaTable.Rows.Count; i++) {
   Console.WriteLine(schemaTable.Rows[i].ItemArray[2].ToString());
}

�ste

Liste tablolar� i�eren bir �rnek bir veritaban� olu�turun...

A�a��daki �rnek, Northwind SQL Server tablolar� listeler veritaban�.

OleDbSchemaGuid.Tables belirli bir oturum i�in eri�ilebilir bu tablolar� (g�r�n�mler dahil olmak �zere) d�nd�r�r. {Null, bo�, bo�, "TABLE"} nesne dizisi belirtirseniz, yaln�zca bir TABLE_TYPE, TABLO eklemek i�in filtre uygulay�n. Sonra tabloyu listeledi�iniz d�nd�r�len �ema tablosundaki her sat�r�n (TABLE_NAME) ad�.

Visual Studio .NET'i ba�lat�n.
Yeni bir Visual C# konsol uygulamas�) projesi olu�turun. Class1.cs, varsay�lan olarak projeye eklenir.
Kod penceresi i�in Class1 a��n. A�a��daki kodu, Code penceresinin �st�ndeki ad alan� bildirimi yap��t�r�n:
using System.Data; using System.Data.OleDb;

Kod penceresinde ana i�levi a�a��daki kodu yap��t�r�n:

OleDbConnection cn = new OleDbConnection();
DataTable schemaTable;

//Connect to the Northwind database in SQL Server.
//Be sure to use an account that has permission to list tables.
cn.ConnectionString = "Provider=SQLOLEDB;Data Source=server;User ID=<username>;
                       Password=<strong password>;Initial Catalog=Northwind";
cn.Open();

//Retrieve schema information about tables.
//Because tables include tables, views, and other objects,
//restrict to just TABLE in the Object array of restrictions.
schemaTable = cn.GetOleDbSchemaTable(OleDbSchemaGuid.Tables, 
              new Object[] {null, null, null, "TABLE"});

//List the table name from each row in the schema table.
for (int i = 0; i < schemaTable.Rows.Count; i++) {
   Console.WriteLine(schemaTable.Rows[i].ItemArray[2].ToString());
}

//Explicitly close - don't wait on garbage collection.
cn.Close();

//Pause
Console.ReadLine();

SQL Server bilgisayar�n�z�n Northwind veritaban�ndaki listede tablolar i�in izni olan bir hesap ile ba�lanmak i�in ConnectionString de�i�tirin.
Derlemek ve proje �al��t�rmak i�in F5 tu�una bas�n. Tablolar, konsol penceresinde listelenen dikkat edin.
Konsol uygulamas� sona erdirmek ve t�mle�ik geli�tirme ortam� (IDE) i�in d�nmek i�in ENTER'E bas�n.

�ste

Bu tablo i�in �ema al�r �rnek olu�turma

A�a��daki �rnek, �al��anlar i�in �ema bilgileri listeler SQL Server Northwind veritaban�ndaki bir tablo.

OleDbSchemaGuid.Tables belirli bir oturum i�in eri�ilebilir bu tablolar� (g�r�n�mler dahil olmak �zere) d�nd�r�r. Nesne dizisi belirtirseniz, {null, bo�, "�al��anlar", "TABLE"}, yaln�zca �al��anlar adl� bir tablo eklemek i�in s�zge�. Ard�ndan, d�nd�r�len �ema tablo i�in �ema bilgileri listeler.

Yeni bir Visual C# konsol uygulamas�) projesi olu�turun. Class1.cs, varsay�lan olarak projeye eklenir.
Kod penceresi i�in Class1 a��n. A�a��daki kodu, Code penceresinin �st�ndeki ad alan� bildirimi yap��t�r�n:
using System.Data; using System.Data.OleDb;

Kod penceresinde ana i�levi a�a��daki kodu yap��t�r�n:

OleDbConnection cn = new OleDbConnection();
DataTable schemaTable;

//Connect to the Northwind database in SQL Server.
//Be sure to use an account that has permission to retrieve table schema.
cn.ConnectionString = "Provider=SQLOLEDB;Data Source=server;User ID=<username>;
                      Password=<strong password>;Initial Catalog=Northwind";
cn.Open();

//Retrieve schema information about the Employees table.
schemaTable = cn.GetOleDbSchemaTable(OleDbSchemaGuid.Tables, 
              new Object[] {null, null, "Employees", "TABLE"});

//List the schema info for the Employees table
//in the format Field Descriptor : Field Value.
for(int i = 0; i < schemaTable.Columns.Count; i++) {
   Console.WriteLine(schemaTable.Columns[i].ToString() + " : " + 
                     schemaTable.Rows[0][i].ToString());
}

//Explicitly close - don't wait on garbage collection.
cn.Close();

//Pause
Console.ReadLine();

SQL Server �al��anlar tablosunu �ema alma iznine sahip bir hesapla bilgisayar�n�za ba�lamak i�in ConnectionString de�i�tirin.
Derlemek ve proje �al��t�rmak i�in F5 tu�una bas�n. Tablolar, konsol penceresinde listelenen dikkat edin.
Konsol uygulamas� sona erdirmek ve �DE'YE d�nmek i�in ENTER'E bas�n.

�ste

Bir tablodaki s�tunlar� listeler, �rnek olu�turma

A�a��daki �rnek �al��anlar� s�tun adlar�, SQL Server Northwind veritaban�ndaki tablo listeler.

OleDbSchemaGuid.Columns bu s�tunlar� Tablo ve g�r�n�mleri, belirli bir oturum a�ma eri�ilebilen verir. {Null, bo�, "�al��anlar", null} nesne dizisi belirtirseniz, yaln�zca �al��anlar tablosunu s�tunlar� eklemek i�in filtre uygulay�n.

Yeni bir Visual C# konsol uygulamas�) projesi olu�turun. Class1.cs, varsay�lan olarak projeye eklenir.
Kod penceresi i�in Class1 a��n. A�a��daki kodu, Code penceresinin �st�ndeki ad alan� bildirimi yap��t�r�n:
using System.Data; using System.Data.OleDb;

Kod penceresinde ana i�levi a�a��daki kodu yap��t�r�n:

OleDbConnection cn = new OleDbConnection();
DataTable schemaTable;

//Connect to the Northwind database in SQL Server.
//Be sure to use an account that has permission to list the columns in the Employees table.
cn.ConnectionString = "Provider=SQLOLEDB;Data Source=server;User ID=<username>;
                       Password=<strong password>;Initial Catalog=Northwind";
cn.Open();

//Retrieve schema information about columns.
//Restrict to just the Employees TABLE.
schemaTable = cn.GetOleDbSchemaTable(OleDbSchemaGuid.Columns, 
              new Object[] {null, null, "Employees", null});

//List the column name from each row in the schema table.
for (int i = 0; i < schemaTable.Rows.Count; i++) {
   Console.WriteLine(schemaTable.Rows[i].ItemArray[3].ToString());
}

//Explicitly close - don't wait on garbage collection.
cn.Close();

//Pause
Console.ReadLine();

SQL Server bilgisayar�n�zda, �al��anlar tablosunda liste s�tun iznine sahip bir hesap ile ba�lanmak i�in ConnectionString de�i�tirin.
Derlemek ve proje �al��t�rmak i�in F5 tu�una bas�n. �al��anlar tablosuna s�tunlar�ndan konsol penceresinde listelenen dikkat edin.
Konsol uygulamas� sona erdirmek ve �DE'YE d�nmek i�in ENTER'E bas�n.

�ste

Bir tablodaki birincil anahtarlar� listeler, �rnek olu�turma

A�a��daki �rnek listeler SQL Server Northwind �al��anlar�n bir birincil anahtar tablosu, veritaban� ve �al��an SQL Server Pubs veritaban�ndaki tablo.

Bu birincil anahtarlar OleDbSchemaGuid.Primary_Keys belirli bir oturum i�in eri�ilebilir bir katalog verir. Bu �rnekte, SQL Server'a, ancak belirli bir SQL Server veritaban�na OleDbConnection ise:

cn.ConnectionString = "Provider=SQLOLEDB;Data Source=server;User ID=<username>;
                       Password=<strong password>;"

yerine, bu kod Northwind ya da pubs veritaban� k�s�tlama dizideki TABLE_CATALOG belirtir. Bu kod, tablonun sahibi, "dbo", TABLE_SCHEMA k�s�tlama i�in belirtir. Buna ek olarak, bu kod, TABLE_NAME k�s�tlama i�in tablo adlar�n� belirtir.

Northwind veritaban�ndaki �al��anlar tablosunun birincil anahtar� edinmek i�in <a0></a0>, {"K�z�l�rmak", "dbo", "�al��anlar"} nesne dizisi kullan�n:

schemaTable = cn.GetOleDbSchemaTable(OleDbSchemaGuid.Primary_Keys, 
              new Object[] {"Northwind", "dbo", "Employees"});

pubs veritaban�ndaki Employee tablosunun birincil anahtar� edinmek i�in <a0></a0>, {"pubs", "dbo", "�al��an"} nesne dizisi kullan�n:

schemaTable = cn.GetOleDbSchemaTable(OleDbSchemaGuid.Primary_Keys, 
              new Object[] {"Pubs", "dbo", "Employee"});

�rnek olu�turmak i�in �u ad�mlar� izleyin:

Yeni bir Visual C# konsol uygulamas�) projesi olu�turun. Class1.cs, varsay�lan olarak projeye eklenir.
Kod penceresi i�in Class1 a��n. A�a��daki kodu, Code penceresinin �st�ndeki ad alan� bildirimi yap��t�r�n:
using System.Data; using System.Data.OleDb;

Kod penceresinde ana i�levi a�a��daki kodu yap��t�r�n:

OleDbConnection cn = new OleDbConnection();
DataTable schemaTable;

//Connect to SQL Server.
//Be sure to use an account that has permissions to list primary keys
//in both the Northwind and Pubs databases.
cn.ConnectionString = "Provider=SQLOLEDB;Data Source=server;User ID=<username>;
                       Password=<strong password>;";
cn.Open();

//Retrieve schema information about primary keys.
//Restrict to just the Employees TABLE in the Northwind CATALOG.
schemaTable = cn.GetOleDbSchemaTable(OleDbSchemaGuid.Primary_Keys, 
              new Object[] {"Northwind", "dbo", "Employees"});

//List the primary key for the first row in the schema table.
//The first three items in the ItemArray in the row are catalog, schema, and table.
//The fourth item is the primary key.
Console.WriteLine(schemaTable.Rows[0].ItemArray[3].ToString());

//Retrieve primary key for the Employee TABLE in the Pubs CATALOG.
schemaTable = cn.GetOleDbSchemaTable(OleDbSchemaGuid.Primary_Keys, 
              new Object[] {"Pubs", "dbo", "Employee"});

//List the primary key for the first row in the schema table.
Console.WriteLine(schemaTable.Rows[0].ItemArray[3].ToString());

//Explicitly close - don't wait on garbage collection.
cn.Close();

//Pause
Console.ReadLine();

SQL Server bilgisayar�n�z�n birincil anahtarlar� listelemek i�in yeterli izinlere sahip bir hesap ile ba�lanmak i�in ConnectionString de�i�tirin.
Derlemek ve proje �al��t�rmak i�in F5 tu�una bas�n. Northwind veritaban�ndaki �al��anlar tablosunu ve �al��an tablosundaki pubs veritaban�ndaki birincil anahtarlar konsolda listelenen fark pencere.
Konsol uygulamas� sona erdirmek ve �DE'YE d�nmek i�in ENTER'E bas�n.

�ste

Referanslar

OleDbSchemaGuid �yeleri tam listesi i�in Microsoft .NET, a�a��daki konuya bak�n Framework Software Development Kit'e (SDK) belgeleri. Kullan�labilir k�s�tlamalar� listesi i�in OleDbSchemaGuid �yelerden birini t�klat�n:

OleDbSchemaGuid �yeler
http://msdn.microsoft.com/en-us/library/system.data.oledb.oledbschemaguid_members.aspx (http://msdn.microsoft.com/en-us/library/system.data.oledb.oledbschemaguid_members.aspx)

Daha fazla bilgi i�in .NET'nda a�a��daki konulara ba�vurun Framework SDK belgelerine:

Bir veritaban�ndan �ema bilgileri edinme
http://msdn.microsoft.com/en-us/library/kcax58fh.aspx (http://msdn.microsoft.com/en-us/library/kcax58fh.aspx)

OleDbConnection.GetOleDbSchemaTable y�ntemi
http://msdn.microsoft.com/en-us/library/system.data.oledb.oledbconnection.getoledbschematable.aspx (http://msdn.microsoft.com/en-us/library/system.data.oledb.oledbconnection.getoledbschematable.aspx)

OleDbSchemaGuid.Tables alan
http://msdn.microsoft.com/en-us/library/system.data.oledb.oledbschemaguid.tables.aspx (http://msdn.microsoft.com/en-us/library/system.data.oledb.oledbschemaguid.tables.aspx)

OleDbSchemaGuid.Columns alan
http://msdn.microsoft.com/en-us/library/system.data.oledb.oledbschemaguid.columns.aspx (http://msdn.microsoft.com/en-us/library/system.data.oledb.oledbschemaguid.columns.aspx)

OleDbSchemaGuid.Primary_Keys alan
http://msdn.microsoft.com/en-us/library/system.data.oledb.oledbschemaguid.primary_keys.aspx (http://msdn.microsoft.com/en-us/library/system.data.oledb.oledbschemaguid.primary_keys.aspx)

�ste

Bu makaledeki bilginin uyguland�� durum:

Microsoft ADO.NET (included with the .NET Framework)
Microsoft ADO.NET 1.1
Microsoft Visual C# .NET 2002 Standard Edition
Microsoft Visual C# .NET 2003 Standard Edition

�ste

kbmt kbhowtomaster kbsystemdata KB309681 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:309681� (http://support.microsoft.com/kb/309681/en-us/ )

�ste

This site in other countries/regions:

Nas�l yap�l�r: GetOleDbSchemaTable ve Visual C# .NET kullanarak �ema bilgilerini al

Bu Sayfada

�zet

Gereksinimler

GetOleDbSchemaTable OleDbConnection nesnesinin y�ntemi

OleDbSchemaGuid �yeler

S�n�rlamalar

D�nd�r�len DataTable

Liste tablolar� i�eren bir �rnek bir veritaban� olu�turun...

Bu tablo i�in �ema al�r �rnek olu�turma

Bir tablodaki s�tunlar� listeler, �rnek olu�turma

Bir tablodaki birincil anahtarlar� listeler, �rnek olu�turma

Referanslar

Bu makaledeki bilginin uyguland�� durum:

Anahtar Kelimeler:�

Di�er Destek Siteleri

Topluluk

Hemen Yard�m Al

Makale �evirileri

This site in other countries/regions:

Nas�l yap�l�r: GetOleDbSchemaTable ve Visual C# .NET kullanarak �ema bilgilerini al

Bu Sayfada

�zet

Gereksinimler

GetOleDbSchemaTable OleDbConnection nesnesinin y�ntemi

OleDbSchemaGuid �yeler

S�n�rlamalar

D�nd�r�len DataTable

Liste tablolar� i�eren bir �rnek bir veritaban� olu�turun...

Bu tablo i�in �ema al�r �rnek olu�turma

Bir tablodaki s�tunlar� listeler, �rnek olu�turma

Bir tablodaki birincil anahtarlar� listeler, �rnek olu�turma

Referanslar

Bu makaledeki bilginin uyguland��� durum:

Anahtar Kelimeler:�

Di�er Destek Siteleri

Topluluk

Hemen Yard�m Al

Makale �evirileri

Bu makaledeki bilginin uyguland�� durum: