資料配接器預覽對話方塊

發行項
08/12/2011

可讓您了解在叫用配接器的 SelectCommand 物件時，資料會如何填入資料集中。使用此對話方塊可供您測試配接器是否傳回預期的資料，了解資料表對應是否運作正常，並確認填入資料集時並未發生錯誤。對話方塊亦可供您測試將不同參數值傳送到配接器的效果。

注意事項
在舊版的 Visual Studio 中，資料配接器是用於應用程式和資料庫之間的通訊。雖然資料配接器仍然是 .NET Framework Data Providers (ADO.NET) 的主要元件，但 TableAdapter 是設計工具產生的元件，它可以簡化在應用程式和資料庫之間的資料管理程序。如需使用 TableAdapter 的詳細資訊，請參閱 TableAdapter 概觀。

如果準備使用配接器，來填入並非由配接器直接產生的資料集，則預覽資料配接器特別有用。

在您執行下列任一動作時，會立即出現對話方塊：

從 [資料] 功能表中選取 [預覽資料]。本功能表僅於資料配接器已加入至表單或元件時有效。
在 [屬性] 視窗底部按一下 [預覽資料] 連結。為資料配接器顯示屬性時可使用本連結。

使用者介面項目清單

資料配接器
在您正在處理的表單或元件上，列示可用的配接器。選取您要預覽的配接器。若要顯示出使用所有資料配接器的結果，請選擇 [<所有的資料配接器>]。
填入資料集
執行命令並於 [結果] 方塊中顯示資料。

如果資料配接器將資料填入資料集時發生錯誤，則錯誤會顯示於訊息方塊中。可能的錯誤包括：
- 資料型別不符。
- SQL 陳述式或預存程序執行時，發生語法錯誤。
- 資料表對應錯誤。例如，如果配接器的 MissingMappingAction 或 MissingSchemaAction 屬性設定為 Error，且倘若資料表對應無法完整說明資料庫和資料集中不符的資料行名稱該如何處理，就會發生錯誤。
- 連接問題。
參數
顯示在指定之資料配接器的 SelectCommand 物件或配接器中所參考的 SQL SELECT 陳述式或預存程序的必要參數。如果沒有必要的參數，則格線為空白。

每個參數皆顯示為格線中的資料列，同時已填入參數名稱與資料型別。在 [値] 方塊中輸入每個參數的值。另外，如果參數可接受，可從 [值] 方塊的下拉式清單中，選取 [<預設>] 或 [<NULL>]。
目標資料集
指定預覽命令應填入資料的目標資料集。您可於專案的所有可用資料集中選取，或者選取填入不具型別資料集 (不具結構描述)。
資料表
在資料集內顯示資料表清單。選取資料表名稱，以查看由資料配接器填入的資料錄 (一般而言，每個資料配接器可於資料集中填入一個資料表)。如果已填滿多個資料表，可於本清單中選取某個資料表來查看資料表的結果。
結果
顯示資料集內的資料。方塊顯示出資料自資料庫傳回，並套用任意資料表對應後，會以何種方式顯示資料。格線中的資料是唯讀的。

如果結果中有多個資料表，您可於 [資料表] 清單中選取其名稱，以檢視特定資料表的內容。
清除結果
清除選取資料表中所有資料。若要清除所有資料表，請選取 [資料表] 清單中的每一個資料表，並針對各資料表按一下 [清除結果]。