Oródwierszową parametr Tworzenie wierszy
Chociaż konsumentów może zapewnić dowolny obiekt zestawu wierszy dla tabela-wyceniane parametry typowy zestaw wierszy obiekty są implementowane przeciwko magazyny danych zaplecza i dlatego zapewnia ograniczoną wydajność.Z tego powodu SQL Server macierzystego klienta OLE DB Provider umożliwia konsumentom utworzyć obiekt specjalistyczne zestaw wierszy na górze w pamięci danych.Ten obiekt zestawu zestaw wierszy specjalnych, w pamięci jest nowy obiekt COM o nazwie tabela-parametr wyceniane zestawu zestaw wierszy.Oferuje ona funkcjonalność podobną do zestawów parametrów.
Parametr oródwierszową obiektów zestawu zestaw wierszy są tworzone jawnie przez konsumenta parametrów wejściowych przez wiele interfejsów poziom sesja.Brak jednego wystąpienia tabela-wyceniane parametr obiektu zestawu zestaw wierszy na tabela-wyceniane parametru.Konsument może utworzyć tabela-wyceniane parametr obiektów zestawu zestaw wierszy, dostarczając informacji metadane jest już znany (scenariusz statyczne) lub przez odkrycie, że za pośrednictwem dostawca interfejsów (scenariusz dynamiczne).W poniższych sekcjach opisano tych dwóch scenariuszy.
Scenariusz statyczne
Gdy znany jest typ informacji, konsument używa ITableDefinitionWithConstraints::CreateTableWithConstraints do tabela-wyceniane parametr obiektu zestawu zestaw wierszy, odpowiadający tabela-wyceniana parametr.
guid Pole (pTableID parametr) zawiera specjalne GUID (CLSID_ROWSET_TVP).pwszName Członkowskie zawiera nazwę tabela-wycenione konsument chce utworzyć wystąpienia typu parametru.eKind Pole będzie zestaw do DBKIND_GUID_NAME.Nazwa ta jest wymagana po instrukcja SQL ad hoc; Nazwa jest opcjonalne, jeśli wywołanie procedury.
agregacja, przekazuje konsumenta pUnkOuter parametr kontrolowanie IUnknown.
Właściwości obiektu wartościami przechowywanymi w tabela parametru zestaw wierszy są tylko do odczytu, tak aby konsument nie oczekuje się Ustaw właściwości rgPropertySets.
Dla rgPropertySets element członkowski konstrukcji DBCOLUMNDESC, konsument może określić dodatkowe właściwości dla każdej kolumna.właściwość te należą do zestaw właściwość DBPROPSET_SQLSERVERCOLUMN.Umożliwiają one określić obliczona i domyślnych ustawień dla każdej kolumna.Obsługują one również, istniejące kolumna właściwości, takie jak opcje dopuszczania wartości null i tożsamości.
Pobrać odpowiednie informacje z tabela-wyceniane parametr obiektu zestawu zestaw wierszy, zastosowań konsumenta IRowsetInfo::GetProperties.
Pobranie informacji o wartości null, unikatowe, obliczone, i zaktualizować stan każdej kolumna Użyj konsumenta IColumnsRowset::GetColumnsRowset lub IColumnsInfo::GetColumnInfo.Metody te zawierają szczegółowe informacje o każdym tabela-wyceniane parametru kolumna zestawu zestaw wierszy.
Konsument określa typ każdej kolumna tabela-parametr wycenione.Jest to podobne jak kolumny są określane podczas tworzenia tabela w SQL Server.Konsument otrzymuje tabela-wyceniane parametr obiektu zestawu zestaw wierszy z SQL Server macierzystego klienta dostawcy OLE DB przez ppRowset parametru wyjściowego.
Scenariusz dynamiczne
Gdy konsument ma typ informacji, należy użyć IOpenRowset::OpenRowset do tabela-wycenione parametr zestaw wierszy obiektów.Konsument musi dostarczyć do dostawca jest nazwa typu.
W tym scenariuszu Dostawca uzyskuje typ informacji o tabela-wyceniane parametr obiektu zestawu zestaw wierszy z serwera w imieniu konsumenta.
pTableID i pUnkOuter Parametry powinny być zestaw w scenariuszu statycznych. SQL Server Macierzystego klienta dostawcy OLE DB następnie uzyskuje informacje o typie (informacje o kolumnie i ograniczenia) z serwera i zwrócić tabela-wyceniane parametr obiektu zestawu zestaw wierszy za pomocą ppRowset parametru.Ta operacja wymaga komunikacji z serwerem i dlatego nie są wykonywane jak również statyczny scenariusz. Dynamiczne scenariusz działa tylko z wywołania procedury sparametryzowanej.