Nasıl yapılır: (C# Programlama Kılavuzu) programlama ofisinde adlandırılmış ve isteğe bağlı bağımsız değişkenlerini kullanma

Makale
02/26/2013

Bağımsız değişkenleri ve isteğe bağlı bağımsız değişkenler olarak adlandırılan Visual C# 2010, rahatlık, esneklik ve C# programlama, okunabilirliği artırmak. Buna ek olarak, bu özellikler Microsoft Office Otomasyonu API gibi com arabirimlerine erişimi büyük ölçüde kolaylaştırır.

Aşağıdaki örnekte, yöntem ConvertToTable on altı gibi biçimlendirme, satır ve sütun sayısını sınırlayan bir tablo özelliklerini temsil eden parametreleri, yazı tipleri ve renkler vardır.Çoğu zaman tüm bunlardan belirli değerleri belirtmek istemiyor çünkü tüm altı parametre isteğe bağlıdır.Ancak, her parametre için sağlanacak bir değer veya bir yer tutucu değer adlandırılmış ve isteğe bağlı bağımsız değişkenler vardır.Adlandırılmış ve isteğe bağlı bağımsız değişkenlerle projeniz için gerekli olan parametreler için değerler belirtin.

Bu yordamları tamamlamak için Microsoft Office Word bilgisayarınızda yüklü olması gerekir.

[!NOT]

Bilgisayarınızda, aşağıdaki yönergelerde yer alan Visual Studio kullanıcı arabirimi öğelerinden bazılarının adı veya konumu farklı gösterilebilir. Bu öğeleri bilgisayarınızdaki Visual Studio sürümü ve kullandığınız ayarlar belirler. Daha fazla bilgi için bkz: Visual Studio ayarları.

Yeni bir konsol uygulaması oluşturmak için

Visual Studio'yu başlatın.
Dosya menüsünde, Yeni'nin üzerine gelin ve Proje'ye tıklatın.
İçinde Şablon kategorileri bölmesinde genişletin **Visual C#**ve ardından Windows.
Üst kısmındaki Ara şablonları emin olmak için bölme .net Framework 4 yer Hedef çerçevesi kutusu.
İçinde şablonları bölmesinde tıklatın Console Application.
İsim alanına projeniz için bir ad yazın.
Tamam düğmesini tıklatın.

Çözüm Gezgini'nde yeni proje görüntülenir.

Bir başvuru eklemek için

İçinde Solution Explorer, projenizin adını sağ tıklatın ve sonra ' Add Reference.Başvuru Ekle iletişim kutusu görüntülenir.
Üzerinde .net sayfası, select Microsoft.Office.Interop.Word , Bileşen adı listesi.
Tamam düğmesini tıklatın.

Eklemek için gerekli yönergeleri kullanma

İçinde Solution Explorer, sağ Program.cs dosya ve ardından View Code.
Aşağıdaki using kodu dosyanın en üstüne yönergeleri.
```
using Word = Microsoft.Office.Interop.Word;
```

Bir Word belgesindeki metni görüntülemek için

De Program Program.cs sınıfı, bir Word uygulaması ve bir Word belgesi oluşturmak için aşağıdaki yöntemi ekleyin.Ekleme yöntemi dört isteğe bağlı parametre vardır.Bu örnek, varsayılan değerleri kullanır.Bu nedenle, arayan deyiminde bağımsız değişken gereklidir.

static void DisplayInWord()
{
    var wordApp = new Word.Application();
    wordApp.Visible = true;
    // docs is a collection of all the Document objects currently 
    // open in Word.
    Word.Documents docs = wordApp.Documents;

    // Add a document to the collection and name it doc. 
    Word.Document doc = docs.Add();
}

Metin belgede görüntüleneceği yeri ve görüntülenecek metni tanımlamak için yöntemin sonuna aşağıdaki kodu ekleyin.

// Define a range, a contiguous area in the document, by specifying
// a starting and ending character position. Currently, the document
// is empty.
Word.Range range = doc.Range(0, 0);

// Use the InsertAfter method to insert a string at the end of the
// current range.
range.InsertAfter("Testing, testing, testing. . .");

Uygulamayı çalıştırmak için

Aşağıdaki ifadeyi Ana menüye ekleyin.
```
DisplayInWord();
```
Project'i çalıştırmak için ctrl + F5 tuşlarına basın.Belirtilen metni içeren bir Word belgesini görünür.

Metni bir tabloya dönüştürmek için

Use ConvertToTable bir tablodaki metni içine yöntemi.Yöntem altı isteğe bağlı parametreleri vardır.IntelliSense aşağıdaki şekilde gösterildiği gibi isteğe bağlı parametreler köşeli parantez iliştirir.

ConvertToTable Parametreler

Adlandırılmış ve isteğe bağlı bağımsız değişkeni, yalnızca değiştirmek istediğiniz parametreler için deðerler belirtmenize olanak verir.Yöntemin sonuna aşağıdaki kod ekleme DisplayInWord basit bir tablo oluşturmak için.Metinde virgülleri de dize değişkeni belirtir range tablo hücreleri ayırın.
```
// Convert to a simple table. The table will have a single row with
// three columns.
range.ConvertToTable(Separator: ",");
```
C#, çağrı, önceki sürümlerindeki ConvertToTable aşağıdaki kodda gösterildiği gibi her parametre için bir başvuru bağımsız değişkeni gerektirir.
```
// Call to ConvertToTable in Visual C# 2008 or earlier. This code
// is not part of the solution.
var missing = Type.Missing;
object separator = ",";
range.ConvertToTable(ref separator, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing,
    ref missing, ref missing, ref missing, ref missing,
    ref missing);
```
Project'i çalıştırmak için ctrl + F5 tuşlarına basın.

Diğer parametrelerle denemek için

Bir sütun ve üç satır sahip olacak şekilde değiştirmek için son satırın yerini DisplayInWord aşağıdaki ifadeyi ve ctrl + F5'e yazın.
```
range.ConvertToTable(Separator: ",", AutoFit: true, NumColumns: 1);
```
Tablo için önceden tanımlanmış bir biçimi belirtmek için son satırın yerini DisplayInWord aşağıdaki ifadeyi ve ctrl + F5'e yazın.Herhangi bir biçimde olabilir WdTableFormat sabitler.
```
range.ConvertToTable(Separator: ",", AutoFit: true, NumColumns: 1,
    Format: Word.WdTableFormat.wdTableFormatElegant);
```

Örnek

Aşağıdaki kod, tam örnek içerir.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Word = Microsoft.Office.Interop.Word;


namespace OfficeHowTo
{
    class WordProgram
    {
        static void Main(string[] args)
        {
            DisplayInWord();
        }

        static void DisplayInWord()
        {
            var wordApp = new Word.Application();
            wordApp.Visible = true;
            // docs is a collection of all the Document objects currently 
            // open in Word.
            Word.Documents docs = wordApp.Documents;

            // Add a document to the collection and name it doc. 
            Word.Document doc = docs.Add();

            // Define a range, a contiguous area in the document, by specifying
            // a starting and ending character position. Currently, the document
            // is empty.
            Word.Range range = doc.Range(0, 0);

            // Use the InsertAfter method to insert a string at the end of the
            // current range.
            range.InsertAfter("Testing, testing, testing. . .");

            // You can comment out any or all of the following statements to
            // see the effect of each one in the Word document.

            // Next, use the ConvertToTable method to put the text into a table. 
            // The method has 16 optional parameters. You only have to specify
            // values for those you want to change.

            // Convert to a simple table. The table will have a single row with
            // three columns.
            range.ConvertToTable(Separator: ",");

            // Change to a single column with three rows..
            range.ConvertToTable(Separator: ",", AutoFit: true, NumColumns: 1);

            // Format the table.
            range.ConvertToTable(Separator: ",", AutoFit: true, NumColumns: 1,
                Format: Word.WdTableFormat.wdTableFormatElegant);
        }
    }
}

Ayrıca bkz.

Kavramlar

Adlandırılmış ve isteğe bağlı bağımsız değişkeni (C# Programlama Kılavuzu)

Aracılığıyla paylaş