SQLXML Yönetilen Sınıfları - SqlXmlCommand Nesnesi

Şunlar için geçerlidir:SQL ServerAzure SQL Veritabanı

Bu, SqlXmlCommand nesnesinin yapıcısıdır:

public SqlXmlCommand(string cnString)  

Burada cnString sunucu, veritabanı ve giriş bilgilerini tanımlayan ADO veya OLEDB bağlantı dizisi - örneğin, Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI".

Bağlantı dizesinde ise Provider SQLOLEDB olmalı ve sağlayıcı Data Provider dizisine dahil edilmemeli).

Çalışma örneği için bkz. SQL Sorgularının Yürütülmesi (SQLXML Yönetilen Sınıflar).

Methods

TheSqlXmlCommand nesnesi, komut çalıştırmak için aşağıdaki yöntemler dahil olmak üzere birkaç yöntemi destekler:

void ExecuteNonQuery()
Komutu çalıştırıyor ama hiçbir şey geri dönmez. Bu yöntem, sorgusuz bir komut (yani hiçbir şey döndürmeyen bir komut) çalıştırmak istiyorsanız faydalıdır. Örneğin, kayıtları güncelleyen ama hiçbir şey döndürmeyen bir updategram veya DiffGram çalıştırmaktır.

Stream ExecuteStream()
Yeni bir Stream nesnesi döndürür. Bu yöntem, sorgu sonuçlarının yeni bir akışta size geri dönmesini istediğinizde faydalıdır. Çalışma örneği için bkz. SQL Sorgularının Yürütülmesi (SQLXML Yönetilen Sınıflar).

public void ExecuteToStream(Stream outputStream)
Sorgu sonuçlarını mevcut bir akışa yazar. Bu yöntem, sonuçların eklenmesi gereken bir akışınız olduğunda (örneğin, sorgu sonuçlarının System.Web.HttpResponse.OutputStream'e yazılması için) faydalıdır. Çalışma örneği için bkz. SQL Sorgularının Yürütülmesi (SQLXML Yönetilen Sınıflar).

XmlReader ExecuteXmlReader()
Bir XmlReader nesnesi döndürüyor. Bu yöntemi doğrudan XmlReader nesnesinde veriyi manipüle etmek veya System.Xml'nin zincirlenebilir mimarisini takmak için kullanabilirsiniz. Daha fazla bilgi için Microsoft .NET Framework dokümantasyonuna bakınız. Çalışma örneği için bkz. ExecuteXMLReader Yöntemi kullanılarak SQL Sorgularını Yürütmek.

TheSqlXmlCommand nesnesi ayrıca şu ek yöntemleri destekler:

SqlXmlParameter CreateParameter()
Bir SqlXmlParameter nesnesi oluşturur. Bu nesnenin Adı ve Değeri parametreleri için değerler ayarlayabilirsiniz. Bu yöntem, parametreleri bir komuta aktarmak istiyorsanız faydalıdır. Çalışma örneği için bkz. SQL Sorgularının Yürütülmesi (SQLXML Yönetilen Sınıflar).

void ClearParameters()
Belirli bir komut nesnesi için oluşturulan parametreleri temizler. Bu yöntem, aynı komut nesnesinde birden fazla sorgu çalıştırmak istiyorsanız faydalıdır.

Özellikler

SqlXmlCommand nesnesi ayrıca şu özellikleri destekler:

ClientSideXml
True olarak ayarlandığında, satır kümesinin XML'e dönüştürülmesinin sunucuda değil, istemci üzerinde gerçekleşeceğini belirtir. Bu özellik, performans yükünü orta seviyeye taşımak istediğinizde faydalıdır. Bu özellik ayrıca mevcut depolanmış prosedürleri FOR XML ile sararak XML çıktısı elde etmenizi sağlar.

Şema Yolu
Eşleme şemasının adı ve dizin yolu (örneğin, C:\x\y\MySchema.xml). Bu özellik, XPath sorguları için bir eşleme şeması belirtmek için faydalıdır. Belirtilen yol mutlak veya göreli olabilir. Eğer yol göreceliyse, Temel Yol'da belirtilen temel yol göreli yolu çözmek için kullanılır. Eğer bir temel yol belirtilmemişse, göreli yol mevcut dizine görecelidir. Çalışma örneği için . NET Ortamında SQLXML Fonksiyonelliğine Erişim bölümüne bakınız.

XslPath
XSL dosyasının adı ve dizin yolu. Belirtilen yol mutlak veya göreli olabilir. Eğer yol göreceliyse, Temel Yol'da belirtilen temel yol göreli yolu çözmek için kullanılır. Eğer bir temel yol belirtilmemişse, göreli yol mevcut dizine görecelidir. Çalışma örneği için bkz. Uygulama XSL Dönüşümü (SQLXML Yönetilen Sınıflar).

Temel Yol
Temel yol (bir dizin yolu). Bu özellik, bir XSL dosyası için belirlenen göreceli yolu (XslPath özelliği kullanılarak), bir eşleme şema dosyası (SchemaPath özelliği kullanılarak) veya bir XML şablonundaki harici şema referansını ( mapping-schema özniteliği kullanılarak belirtilen) çözmek için faydalıdır.

OutputEncoding
Komut çalıştırıldığında döndürülen akış için kodlamayı belirtir. Bu özellik, geri dönen akış için belirli bir kodlama talep etmek için faydalıdır. Yaygın olarak kullanılan bazı kodlamalar UTF-8, ANSI ve Unicode'dur. UTF-8 varsayılan kodlamadır.

Namespace'ler
Isim alanları kullanan XPath sorgularının yürütülmesini etkinleştirir. Namespaces'li XPath sorguları hakkında daha fazla bilgi için Namespaces ile XPath Sorgularının Yürütülmesi (SQLXML Managed Classes) bölümüne bakınız. Çalışma örneği için bkz. XPath Sorgularının Yürütülmesi (SQLXML Yönetilen Sınıflar).

RootTag
Komut çalıştırma ile oluşturulan XML için tek kök eleman sağlar. Geçerli bir XML belgesi tek bir kök seviyesinde etiket gerektirir. Çalıştırılan komut bir XML parçası üretiyorsa (tek bir üst seviye eleman olmadan), geri dönen XML için bir kök eleman belirtebilirsiniz. Çalışma örneği için bkz. Uygulama XSL Dönüşümü (SQLXML Yönetilen Sınıflar).

CommandText
Komutun metni. Bu özellik, çalıştırmak istediğiniz komutun metnini belirtmek için kullanılır. Çalışma örneği için bkz. SQL Sorgularının Yürütülmesi (SQLXML Yönetilen Sınıflar).

CommandStream
Komut akışı. Bu özellik, bir dosyadan (örneğin bir XML şablonu) komut çalıştırmak istiyorsanız faydalıdır. CommandStream kullandığınızda sadece "Template", "UpdateGram" ve "DiffGram" CommandType değerleri desteklenir. Çalışma örneği için CommandStream özelliğini kullanarak Şablon Dosyalarını Çalıştırma bölümüne bakınız.

CommandType
Komut türünü belirler. Bu özellik, çalıştırmak istediğiniz komut türünü belirtmek için kullanılır. Aşağıdaki tablodaki değerler komutun türünü belirler. Çalışma örneği için . NET Ortamında SQLXML Fonksiyonelliğine Erişim bölümüne bakınız.

Değer	Description
SqlXmlCommandType.Sql	Bir SQL komutu çalıştırır (örneğin, SELECT * FROM Employees FOR XML AUTO).
SqlXmlCommandType.XPath	Bir XPath komutunu çalıştırır (örneğin, Employees[@EmployeeID=1]).
SqlXmlCommandType.Template	Bir XML şablonu çalıştırır.
SqlXmlCommandType.TemplateFile	Belirtilen yolda bir şablon dosyası çalıştırır.
SqlXmlCommandType.UpdateGram	Bir güncelleme gramı çalıştırıyor.
SqlXmlCommandType.Diffgram	Bir DiffGram çalıştırır.

Ayrıca Bkz.

SqlXmlParameter Object (SQLXML Managed Classes)
SqlXmlAdapter Object (SQLXML Managed Classes)