如何從 Microsoft Visual C#.NET 將 Microsoft Excel 自動化

發行項
06/20/2023
適用於:

Microsoft Excel

摘要

本文示範如何使用 Microsoft Visual C# .NET 建立 Microsoft Excel 的自動化用戶端。

其他相關資訊

自動化是一種程式，允許以 Visual C# .NET 等語言撰寫的應用程式，以程式設計方式控制其他應用程式。自動化至 Excel 可讓您執行動作，例如建立新的活頁簿、將資料新增至活頁簿，或建立圖表。使用 Excel 和其他 Microsoft Office 應用程式，您幾乎可以透過使用者介面手動執行的所有動作，也可以使用自動化以程式設計方式執行。

Excel 會透過物件模型公開此程式設計功能。物件模型是類別和方法的集合，可做為 Excel 邏輯元件的對應專案。例如，有一個 Application 物件、一個 Workbook 物件和一個 Worksheet 物件，每個物件都包含這些 Excel 片段的功能。若要從 Visual C# .NET 存取物件模型，您可以設定型別程式庫的專案參考。

本文示範如何將適當的專案參考設定為適用于 Visual C# .NET 的 Excel 型別程式庫，並提供範例程式碼來自動化 Excel。

建立適用于 Microsoft Excel 的自動化用戶端

啟動 Microsoft Visual Studio .NET。
在 [檔案] 功能表上，按一下 [新增]，然後按一下 [專案]。從 Visual C# 專案類型中選取 [Windows 應用程式]。根據預設，會建立 Form1。
新增 Microsoft Excel 物件程式庫的參考。如果要執行這項操作，請依照下列步驟執行：
1. 按一下 [專案] 功能表上的 [加入參考]。
2. 在 [COM] 索引標籤上，找出 [Microsoft Excel 物件程式庫]，然後按一下 [選取]。
注意 Microsoft Office 2003 包含主要 Interop 元件 (PIA) 。 Microsoft Office XP 不包含 PIA，但可以下載。
1. 按一下 [新增參考] 對話方塊中的 [確定] 以接受您的選擇。如果系統提示您為選取的程式庫產生包裝函式，請按一下 [是]。
在 [檢視] 功能表上，選取 [工具箱] 以顯示工具箱，然後將按鈕新增至 Form1。
按兩下 Button1。表單的程式碼視窗隨即出現。

在程式碼視窗中，取代下列程式碼：

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

搭配：

private void button1_Click(object sender, System.EventArgs e)
{
Excel.Application oXL;
Excel._Workbook oWB;
Excel._Worksheet oSheet;
Excel.Range oRng;

try
{
//Start Excel and get Application object.
oXL = new Excel.Application();
oXL.Visible = true;

//Get a new workbook.
oWB = (Excel._Workbook)(oXL.Workbooks.Add( Missing.Value ));
oSheet = (Excel._Worksheet)oWB.ActiveSheet;

//Add table headers going cell by cell.
oSheet.Cells[1, 1] = "First Name";
oSheet.Cells[1, 2] = "Last Name";
oSheet.Cells[1, 3] = "Full Name";
oSheet.Cells[1, 4] = "Salary";

//Format A1:D1 as bold, vertical alignment = center.
oSheet.get_Range("A1", "D1").Font.Bold = true;
oSheet.get_Range("A1", "D1").VerticalAlignment = 
Excel.XlVAlign.xlVAlignCenter;

// Create an array to multiple values at once.
string[,] saNames = new string[5,2];

saNames[ 0, 0] = "John";
saNames[ 0, 1] = "Smith";
saNames[ 1, 0] = "Tom";
saNames[ 1, 1] = "Brown";
saNames[ 2, 0] = "Sue";
saNames[ 2, 1] = "Thomas";
saNames[ 3, 0] = "Jane";
saNames[ 3, 1] = "Jones";
saNames[ 4, 0] = "Adam";
saNames[ 4, 1] = "Johnson";

//Fill A2:B6 with an array of values (First and Last Names).
     oSheet.get_Range("A2", "B6").Value2 = saNames;

//Fill C2:C6 with a relative formula (=A2 & " " & B2).
oRng = oSheet.get_Range("C2", "C6");
oRng.Formula = "=A2 & \" \" & B2";

//Fill D2:D6 with a formula(=RAND()*100000) and apply format.
oRng = oSheet.get_Range("D2", "D6");
oRng.Formula = "=RAND()*100000";
oRng.NumberFormat = "$0.00";

//AutoFit columns A:D.
oRng = oSheet.get_Range("A1", "D1");
oRng.EntireColumn.AutoFit();

//Manipulate a variable number of columns for Quarterly Sales Data.
DisplayQuarterlySales(oSheet);

//Make sure Excel is visible and give the user control
//of Microsoft Excel's lifetime.
oXL.Visible = true;
oXL.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" );
}
}

private void DisplayQuarterlySales(Excel._Worksheet oWS)
{
Excel._Workbook oWB;
Excel.Series oSeries;
Excel.Range oResizeRange;
Excel._Chart oChart;
String sMsg;
int iNumQtrs;

//Determine how many quarters to display data for.
for( iNumQtrs = 4; iNumQtrs >= 2; iNumQtrs--)
{
sMsg = "Enter sales data for ";
sMsg = String.Concat( sMsg, iNumQtrs );
sMsg = String.Concat( sMsg, " quarter(s)?");

DialogResult iRet = MessageBox.Show( sMsg, "Quarterly Sales?", 
MessageBoxButtons.YesNo );
if (iRet == DialogResult.Yes)
break;
}

sMsg = "Displaying data for ";
sMsg = String.Concat( sMsg, iNumQtrs );
sMsg = String.Concat( sMsg, " quarter(s)." );

MessageBox.Show( sMsg, "Quarterly Sales" );

//Starting at E1, fill headers for the number of columns selected.
oResizeRange = oWS.get_Range("E1", "E1").get_Resize( Missing.Value, iNumQtrs);
oResizeRange.Formula = "=\"Q\" & COLUMN()-4 & CHAR(10) & \"Sales\"";

//Change the Orientation and WrapText properties for the headers.
oResizeRange.Orientation = 38;
oResizeRange.WrapText = true;

//Fill the interior color of the headers.
oResizeRange.Interior.ColorIndex = 36;

//Fill the columns with a formula and apply a number format.
oResizeRange = oWS.get_Range("E2", "E6").get_Resize( Missing.Value, iNumQtrs);
oResizeRange.Formula = "=RAND()*100";
oResizeRange.NumberFormat = "$0.00";

//Apply borders to the Sales data and headers.
oResizeRange = oWS.get_Range("E1", "E6").get_Resize( Missing.Value, iNumQtrs);
oResizeRange.Borders.Weight = Excel.XlBorderWeight.xlThin;

//Add a Totals formula for the sales data and apply a border.
oResizeRange = oWS.get_Range("E8", "E8").get_Resize( Missing.Value, iNumQtrs);
oResizeRange.Formula = "=SUM(E2:E6)";
oResizeRange.Borders.get_Item( Excel.XlBordersIndex.xlEdgeBottom ).LineStyle 
= Excel.XlLineStyle.xlDouble;
oResizeRange.Borders.get_Item( Excel.XlBordersIndex.xlEdgeBottom ).Weight 
= Excel.XlBorderWeight.xlThick;

//Add a Chart for the selected data.
oWB = (Excel._Workbook)oWS.Parent;
oChart = (Excel._Chart)oWB.Charts.Add( Missing.Value, Missing.Value, 
Missing.Value, Missing.Value );

//Use the ChartWizard to create a new chart from the selected data.
oResizeRange = oWS.get_Range("E2:E6", Missing.Value ).get_Resize( 
Missing.Value, iNumQtrs);
oChart.ChartWizard( oResizeRange, Excel.XlChartType.xl3DColumn, Missing.Value,
Excel.XlRowCol.xlColumns, Missing.Value, Missing.Value, Missing.Value, 
Missing.Value, Missing.Value, Missing.Value, Missing.Value );
oSeries = (Excel.Series)oChart.SeriesCollection(1);
oSeries.XValues = oWS.get_Range("A2", "A6");
for( int iRet = 1; iRet <= iNumQtrs; iRet++)
{
oSeries = (Excel.Series)oChart.SeriesCollection(iRet);
String seriesName;
seriesName = "=\"Q";
seriesName = String.Concat( seriesName, iRet );
seriesName = String.Concat( seriesName, "\"" );
oSeries.Name = seriesName;
}  

oChart.Location( Excel.XlChartLocation.xlLocationAsObject, oWS.Name );

//Move the chart so as not to cover your data.
oResizeRange = (Excel.Range)oWS.Rows.get_Item(10, Missing.Value );
oWS.Shapes.Item("Chart 1").Top = (float)(double)oResizeRange.Top;
oResizeRange = (Excel.Range)oWS.Columns.get_Item(2, Missing.Value );
oWS.Shapes.Item("Chart 1").Left = (float)(double)oResizeRange.Left;
}

捲動至程式碼視窗的頂端。將下列這一行新增至 using 指示詞清單的結尾：
```
using Excel = Microsoft.Office.Interop.Excel;
using System.Reflection; 
```

測試自動化用戶端

按 F5 建置並執行程式。
按一下表單上的 [Button1]。此程式會啟動 Excel，並在新的工作表中填入資料。
當系統提示您輸入每季銷售資料時，請按一下 [是]。連結到每季資料的圖表會新增至工作表。

參考

如需詳細資訊，請參閱 MICROSOFT 開發人員網路 (MSDN) 網站。

如何從 Microsoft Visual C#.NET 將 Microsoft Excel 自動化

摘要

其他相關資訊

建立適用于 Microsoft Excel 的自動化用戶端

測試自動化用戶端

參考

其他資源