共用方式為

逐步解說：Office 程式設計 (C# 和 Visual Basic)

  • 發行項

Visual Studio 2010 在 C# 和 Visual Basic 中開始採用改善 Microsoft Office 程式設計的新功能。 每一種語言都已經加入其他語言的現有功能。

C# 中的新功能包含具名及選擇性引數、類型為 dynamic 的傳回值，以及 COM 程式設計中省略 ref 關鍵字以及存取已編製索引之屬性的能力。 Visual Basic 中的新功能包含自動實作的屬性、Lambda 運算式中的陳述式，以及集合初始設定式。

這兩種語言都會啟用類型資訊的內嵌，以允許部署與 COM 元件互動的組件，而不需要將主要 Interop 組件 (PIA) 部署至使用者電腦。 如需詳細資訊，請參閱逐步解說：從 Managed 組件內嵌類型 (C# 和 Visual Basic)。

這個逐步解說將會示範 Office 程式設計內容中的新功能，但其中大部分也適用於一般的程式設計。 在這個逐步解說中，您會先使用 Excel 增益集應用程式來建立 Excel 活頁簿。 接著，您會建立含有活頁簿連結的 Word 文件。 最後，您會看到如何開啟和關閉 PIA 相依性。

必要條件

您必須已在電腦上安裝 Microsoft Office Excel 2013 (或 2007 版或更新版本) 以及 Microsoft Office Word 2013 (或 2007 版或更新版本)，才能完成這個逐步解說。

如果您使用 Windows Vista 以前的作業系統，請確定已安裝 .NET Framework 2.0。

注意事項注意事項

您的電腦對於下列指示中某些 Visual Studio 使用者介面項目的名稱或位置，可能會顯示不同的資訊：您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。如需詳細資訊，請參閱＜Visual Studio 中的自訂開發設定＞。

設定 Excel 增益集應用程式

  1. 啟動 Visual Studio。

  2. 在 [檔案] 功能表中，指向 [新增]，然後按一下 [專案]。

  3. 在 [已安裝的範本] 窗格中，展開 [Visual Basic] 或 [Visual C#]，並展開 [Office]，然後按一下 [2013] (或 [2010] 或 [2007])。

  4. 在 [範本] 窗格中，按一下 [Excel 2013 增益集] (或 [Excel 2010 增益集] 或 [Excel 2007 增益集])。

  5. 查看 [範本] 窗格頂端，確定 [.NET Framework 4] 或更新版本出現在 [目標 Framework] 方塊中。

  6. 視需要在 [名稱] 方塊中，輸入您專案的名稱。

  7. 按一下 [確定]。

  8. 新的專案隨即會出現在 [方案總管] 中。

加入參考

  1. 在 [方案總管] 中，於專案名稱上按一下滑鼠右鍵，然後按一下 [加入參考]。 [加入參考] 對話方塊隨即出現。

  2. 在 [組件] 索引標籤上，選取 [Microsoft.Office.Interop.Excel] 15.0.0.0 版 (或 Excel 2010 14.0.0.0 版或 Excel 2007 12.0.0.0 版)，並在 [元件名稱] 清單中，按住 CTRL 鍵，然後選取 [Microsoft.Office.Interop.Word] 15.0.0.0 版 (或 Word 2010 14.0.0.0 版或 Word 2007 12.0.0.0 版)。 如果看不到組件，則可能需要確定它們已安裝並已顯示 (請參閱如何：安裝 Office 主要 Interop 組件)。

  3. 按一下 [確定]。

加入必要的 Imports 陳述式或 using 指示詞

  1. 在 [方案總管] 中，於 ThisAddIn.vb 或 ThisAddIn.cs 檔案上按一下滑鼠右鍵，然後按一下 [檢視程式碼]。

  2. 將下列 Imports 陳述式 (Visual Basic) 或 using 指示詞 (C#) 加入還沒有這兩者的程式碼檔案頂端。

    Imports Microsoft.Office.Interop

    using System.Collections.Generic;
using Excel = Microsoft.Office.Interop.Excel;
using Word = Microsoft.Office.Interop.Word;

建立銀行帳戶清單

  1. 在 [方案總管] 中，於專案名稱上按一下滑鼠右鍵，並按一下 [新增]，然後按一下 [類別]。 如果您使用 Visual Basic，請將類別命名為 Account.vb；如果您使用 C#，則請將類別命名為 Account.cs。 按一下 [加入]。

  2. 將 Account 類別的定義取代為下列程式碼。 類別定義使用「自動實作屬性」(auto-implemented property) (Visual Studio 2010 中 Visual Basic 的新功能)。 如需詳細資訊，請參閱自動實作的屬性 (Visual Basic)。

    Public Class Account
    Property ID As Integer = -1
    Property Balance As Double 
End Class

    class Account
{
    public int ID { get; set; }
    public double Balance { get; set; }
}

  3. 若要建立含有兩個帳戶的 bankAccounts 清單，請將下列程式碼加入 ThisAddIn.vb 或 ThisAddIn.cs 中的 ThisAddIn_Startup 方法。 清單宣告使用「集合初始設定式」(collection initializer) (Visual Studio 2010 中 Visual Basic 的新功能)。 如需詳細資訊，請參閱集合初始設定式 (Visual Basic)。

    Dim bankAccounts As New List(Of Account) From {
    New Account With {
                          .ID = 345,
                          .Balance = 541.27
                     },
    New Account With {
                          .ID = 123,
                          .Balance = -127.44
                     }
    }

    var bankAccounts = new List<Account> 
{
    new Account 
    {
        ID = 345,
        Balance = 541.27
    },
    new Account 
    {
        ID = 123,
        Balance = -127.44
    }
};

將資料匯出至 Excel

  1. 在相同的檔案中，將下列方法加入 ThisAddIn 類別。 這個方法會設定 Excel 活頁簿，並將資料匯出到 Excel 活頁簿。

    Sub DisplayInExcel(ByVal accounts As IEnumerable(Of Account),
               ByVal DisplayAction As Action(Of Account, Excel.Range))

    With Me.Application
        ' Add a new Excel workbook.
        .Workbooks.Add()
        .Visible = True
        .Range("A1").Value = "ID"
        .Range("B1").Value = "Balance"
        .Range("A2").Select()

        For Each ac In accounts
            DisplayAction(ac, .ActiveCell)
            .ActiveCell.Offset(1, 0).Select()
        Next 

        ' Copy the results to the Clipboard.
        .Range("A1:B3").Copy()
    End With 
End Sub

    void DisplayInExcel(IEnumerable<Account> accounts,
           Action<Account, Excel.Range> DisplayFunc)
{
    var excelApp = this.Application;
    // Add a new Excel workbook.
    excelApp.Workbooks.Add();
    excelApp.Visible = true;
    excelApp.Range["A1"].Value = "ID";
    excelApp.Range["B1"].Value = "Balance";
    excelApp.Range["A2"].Select();

    foreach (var ac in accounts)
    {
        DisplayFunc(ac, excelApp.ActiveCell);
        excelApp.ActiveCell.Offset[1, 0].Select();
    }
    // Copy the results to the Clipboard.
    excelApp.Range["A1:B3"].Copy();
}

    在這個方法中，使用了兩個新的 C# 功能。 這兩個功能已存在於 Visual Basic 中。

    • 方法 Add (英文) 具有「選擇性參數」(optional parameter)，可指定特定範本。 如果您想要使用參數的預設值，則可利用選擇性參數 (Visual C# 2010 中的新功能) 省略該參數的引數。 因為上一個範例中未傳送引數，所以 Add 會使用預設範本並建立新的活頁簿。 舊版 C# 中對等的陳述式需要有預留位置引數：excelApp.Workbooks.Add(Type.Missing)。

      如需詳細資訊，請參閱具名和選擇性引數 (C# 程式設計手冊)。

    • Range 物件的 Range 和 Offset 屬性，使用「編製過索引的屬性」(indexed property) 功能。 您可利用這項功能使用下列一般 C# 語法，來使用 COM 類型的這些屬性。 您可利用編製過索引的屬性，使用 Range 物件的 Value 屬性，而不需要使用 Value2 屬性。 Value 屬性編製過索引，但您可選擇是否要編製索引。 在下列範例中，同時使用了選擇性引數與編製過索引的屬性。

      // Visual C# 2010 provides indexed properties for COM programming.
excelApp.Range["A1"].Value = "ID";
excelApp.ActiveCell.Offset[1, 0].Select();

      在舊版語言中，需要下列特殊語法。

      // In Visual C# 2008, you cannot access the Range, Offset, and Value 
// properties directly.
excelApp.get_Range("A1").Value2 = "ID";
excelApp.ActiveCell.get_Offset(1, 0).Select();

      您無法建立自己本身的編製過索引的屬性。 這個功能僅支援使用現有已編製過索引的屬性。

      如需詳細資訊，請參閱如何：在 COM Interop 程式設計中使用索引的屬性 (C# 程式設計手冊)。

  2. 在 DisplayInExcel 結尾加入下列程式碼，以調整資料行寬度以容納內容。

    ' Add the following two lines at the end of the With statement.
.Columns(1).AutoFit()
.Columns(2).AutoFit()

    excelApp.Columns[1].AutoFit();
excelApp.Columns[2].AutoFit();

    這些新增內容可示範 C# 2010 中的另一項新功能：將 COM 主機 (例如 Office) 傳回的 Object 值，視為具有類型 dynamic。 如果已將 [內嵌 Interop 類型] 設定為其預設值 True；或同樣地，當 /link 編譯器選項參考了組件時，則會自動發生這種情況。 dynamic 類型可以進行晚期繫結 (Visual Basic 中已有這個功能)，並避免在 Visual C# 2008 和語言舊版本中需要明確轉型。

    例如，excelApp.Columns[1] 會傳回 Object，而 AutoFit 是 Excel Range 方法 (英文)。 如果沒有 dynamic，則在呼叫 AutoFit 方法之前，必須將 excelApp.Columns[1] 所傳回的物件，轉型為 Range 執行個體。

    // Casting is required in Visual C# 2008.
((Excel.Range)excelApp.Columns[1]).AutoFit();

// Casting is not required in Visual C# 2010.
excelApp.Columns[1].AutoFit();

    如需內嵌 Interop 類型的詳細資訊，請參閱本主題稍後的＜尋找 PIA 參考＞和＜還原 PIA 相依性＞程序。 如需 dynamic 的詳細資訊，請參閱dynamic (C# 參考)或使用動態類型 (C# 程式設計手冊)。

叫用 DisplayInExcel

  1. 在 ThisAddIn_StartUp 方法的結尾，加入下列程式碼。 DisplayInExcel 呼叫包含兩個引數。 第一個引數是要處理的帳戶清單名稱。 第二個引數則是多行的 Lambda 運算式，定義如何處理資料。 每個帳戶的 ID 和 balance 值都會顯示在相鄰的儲存格中，而且如果餘額小於零，則會以紅色顯示資料列。 多行 Lambda 運算式是 Visual Basic 2010 中的新功能。 如需詳細資訊，請參閱Lambda 運算式 (Visual Basic)。

    DisplayInExcel(bankAccounts,
       Sub(account, cell)
           ' This multiline lambda expression sets custom 
           ' processing rules for the bankAccounts.
           cell.Value = account.ID
           cell.Offset(0, 1).Value = account.Balance

           If account.Balance < 0 Then
               cell.Interior.Color = RGB(255, 0, 0)
               cell.Offset(0, 1).Interior.Color = RGB(255, 0, 0)
           End If 
       End Sub)

    DisplayInExcel(bankAccounts, (account, cell) =>
// This multiline lambda expression sets custom processing rules   
// for the bankAccounts.
{
    cell.Value = account.ID;
    cell.Offset[0, 1].Value = account.Balance;
    if (account.Balance < 0)
    {
        cell.Interior.Color = 255;
        cell.Offset[0, 1].Interior.Color = 255;
    }
});

  2. 若要執行程式，請按 F5 鍵。 隨即會出現內含帳戶資料的 Excel 工作表。

加入 Word 文件

  • 在 ThisAddIn_StartUp 方法的結尾加入下列程式碼，可以建立內含 Excel 活頁簿連結的 Word 文件。

    Dim wordApp As New Word.Application
wordApp.Visible = True
wordApp.Documents.Add()
wordApp.Selection.PasteSpecial(Link:=True, DisplayAsIcon:=True)

    var wordApp = new Word.Application();
wordApp.Visible = true;
wordApp.Documents.Add();
wordApp.Selection.PasteSpecial(Link: true, DisplayAsIcon: true);

    這個程式碼將會示範 C# 中的數個新功能：省略 COM 程式設計中 ref 關鍵字、具名引數和選擇性引數的能力。 Visual Basic 中已有這些功能。 PasteSpecial 方法 (英文) 有七個參數，全部都定義為選擇性參考參數。 在 Visual C# 2010 之前，您必須定義物件變數以用做為七個參數的引數，即使您沒有要傳入任何有意義的值也是一樣。 您可利用具名引數和選擇性引數，指定想要依名稱存取的參數，以及將引數只傳送給那些參數。 在這個範例中會傳送引數，表示應建立剪貼簿上的活頁簿連結 (參數 Link)，且連結會以圖示形式顯示在 Word 文件中 (參數 DisplayAsIcon)。 在 Visual C# 2010 中也可省略這些引數的 ref 關鍵字。 請比對 Visual C# 2008 中的下列程式碼片段與 Visual C# 2010 中所需的單一行：

    // Call to PasteSpecial in Visual C# 2008. 
object iconIndex = Type.Missing;
object link = true;
object placement = Type.Missing;
object displayAsIcon = true;
object dataType = Type.Missing;
object iconFileName = Type.Missing;
object iconLabel = Type.Missing;
wordApp.Selection.PasteSpecial(ref iconIndex,
                               ref link,
                               ref placement,
                               ref displayAsIcon,
                               ref dataType,
                               ref iconFileName,
                               ref iconLabel);

// Call to PasteSpecial in Visual C# 2010.
wordApp.Selection.PasteSpecial(Link: true, DisplayAsIcon: true);

若要執行應用程式

  • 按 F5 執行應用程式。 隨即會啟動 Excel，並會顯示含有 bankAccounts 中兩個帳戶資訊的資料表。 然後，會出現包含 Excel 資料表連結的 Word 文件。

清除已完成的專案

  • 在 Visual Studio 中，按一下 [建置] 功能表上的 [清除方案]。 否則，每次在電腦上開啟 Excel 時，都會執行增益集。

尋找 PIA 參考

  1. 重新執行應用程式，但不要按 [清除方案]。

  2. 在 [開始] 功能表上，按一下 [所有程式]。 接著，依序按一下 [Microsoft Visual Studio 2013]、[Visual Studio Tools] 和 [Visual Studio 命令提示字元 (2013)]。

  3. 在 [Visual Studio 命令提示字元 (2013)] 視窗中輸入 ildasm，然後按 ENTER 鍵。 隨即會出現 IL DASM 視窗。

  4. 在 IL DASM 視窗的 [檔案] 功能表上，按一下 [開啟]。 按兩下 [Visual Studio 2013]，然後按兩下 [專案]。 開啟您專案的資料夾，並查看 bin/Debug 資料夾中 您的專案名稱.dll。 按兩下 您的專案名稱.dll。 新的視窗除了顯示會其他模組和組件的參考之外，還會顯示您專案的屬性。 請注意，組件中會包含命名空間 Microsoft.Office.Interop.Excel 和 Microsoft.Office.Interop.Word。 在 Visual Studio 2013 中，編譯器預設會將您所需要的類型從參考的 PIA 匯入組件。

    如需詳細資訊，請參閱如何：檢視組件內容。

  5. 按兩下 MANIFEST 圖示。 隨即會出現一個視窗，內含專案所參考之項目的組件清單。 Microsoft.Office.Interop.Excel 和 Microsoft.Office.Interop.Word 未包含在清單中。 因為您專案所需的類型已匯入組件中，所以不需要 PIA 參考。 這會讓部署更為容易。 PIA 不需要存在於使用者的電腦上，而且因為應用程式不需要部署特定版本的 PIA，所以應用程式可以設計成與多個版本的 Office 搭配使用，但前提是所有版本都有必要的 API。

    因為不再需要部署 PIA，所以您可以在使用多個版本 Office (包括舊版本) 的進階情況下，建立應用程式。 不過，這只適用於程式碼未使用供任何 API 時 (目前所用 Office 版本中不提供)。 您不一定清楚舊版本中是否有特定 API，也因為此，不建議使用舊版 Office。

    注意事項注意事項

    在 Office 2003 之前，Office 未發行 PIA。因此，產生 Office 2002 或舊版 Interop 組件唯一的方法，是匯入 COM 參考。

  6. 關閉資訊清單視窗和組件視窗。

還原 PIA 相依性

  1. 在 [方案總管] 中，按一下 [顯示所有檔案] 按鈕。 展開 [參考] 資料夾，然後選取 [Microsoft.Office.Interop.Excel]。 按 F4 顯示 [屬性] 視窗。

  2. 在 [屬性] 視窗中，將 [內嵌 Interop 類型] 屬性從 [True] 變更為 [False]。

  3. 為 Microsoft.Office.Interop.Word，重複本程序中的步驟 1 和 2。

  4. 在 C# 中，將 DisplayInExcel 方法結尾的兩個 Autofit 呼叫標為註解。

  5. 按 F5 鍵，確認專案仍然正確地執行。

  6. 重複前一個程序中的步驟 1-3，開啟組件視窗。 請注意，Microsoft.Office.Interop.Word 和 Microsoft.Office.Interop.Excel 已不在內嵌的組件清單中。

  7. 按兩下 [MANIFEST] 圖示，並捲動所參考之組件的清單。 Microsoft.Office.Interop.Word 和 Microsoft.Office.Interop.Excel 都在清單中。 因為應用程式會參考 Excel 和 Word PIA，而且 [內嵌 Interop 類型] 屬性設定為 [False]，所以這兩個組件都必須存在於使用者的電腦上。

  8. 在 Visual Studio 中，按一下 [建置] 功能表上的 [清除方案]，清除已完成的專案。

請參閱

工作

如何：在 COM Interop 程式設計中使用索引的屬性 (C# 程式設計手冊)

逐步解說：從 Microsoft Office 組件內嵌類型資訊 (C# 和 Visual Basic)

逐步解說：從 Managed 組件內嵌類型 (C# 和 Visual Basic)

逐步解說：建立 Excel 的第一個應用程式層級增益集

參考

自動實作的屬性 (C# 程式設計手冊)

物件和集合初始設定式 (C# 程式設計手冊)

dynamic (C# 參考)

Lambda 運算式 (C# 程式設計手冊)

互通性 (C# 程式設計手冊)

概念

自動實作的屬性 (Visual Basic)

集合初始設定式 (Visual Basic)

選擇性參數 (Visual Basic)

依位置和名稱傳遞引數 (Visual Basic)

具名和選擇性引數 (C# 程式設計手冊)

早期和晚期繫結 (Visual Basic)

Lambda 運算式 (Visual Basic)

其他資源

使用動態類型 (C# 程式設計手冊)

COM Interop (Visual Basic)