Metoda GetRangeString
Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Należy unikać stosowania tej funkcji w nowych projektach oraz zaplanować modyfikację aplikacji, w których obecnie jest używana ta funkcja.
GetRangeString Metoda zwraca jeden ciąg znaków zawiera blok wierszy i kolumn z bieżącego zestaw wyników QueryResults obiektu.
Składnia
object
.GetRangeString( [ Top ] , [ Left ] , [ Bottom ] , [ Right ] ,
[ RowDelimiter ] , [ ColDelimiter ] , [ ColWidths ] )as String
Części
obiekt
Wyrażenie, którego wartością obiekt na liście dotyczy.U góry
Opcjonalne.Długa liczba całkowita, która określa początkowy wierszy zestaw wyników.Jeśli nie określono wartości, zwrócony ciąg w pierwszym wierszu powstaje z nazwy kolumn zestaw wyników.Lewa
Opcjonalne.Długa liczba całkowita, która określa początkowy kolumny w zestaw wyników.Jeśli nie określono wartości, pierwsza kolumna znaczniki po lewej stronie wyodrębnione zakres.najmniejsza_wartość
Opcjonalne.Długa liczba całkowita określająca zakończenia wierszy zestaw wyników.Gdy nie określono wartości, ostatni wiersz oznacza dołu wyodrębnione zakres.Prawa
Opcjonalne.Długa liczba całkowita, która określa zakończenia kolumny w zestaw wyników.Gdy nie określono wartości, ostatnia kolumna znaki po prawej stronie wyodrębnione zakres.RowDelimiter
Opcjonalne.Ciąg używany do rozdzielenia wierszy.Jeśli nie określono wartości, wiersze są rozdzielane przy użyciu powrotu karetki/wysuwu wiersza sekwencji.ColDelimiter
Opcjonalne.Ciąg używany do rozdzielenia kolumn.Jeśli nie określono wartości, kolumny są rozdzielane przy użyciu znaku tabulacji, niezależnie od ustawienia ColWidths argumentu.ColWidths
Opcjonalne.ciąg SQL Distributed Management Objects (SQL-DMO) wielokrotnego wartości Liczba całkowita określająca stałej szerokości reprezentacja wartości ciąg.Jeśli nie określono wartości w ColDelimiter argument, dane są reprezentowane w ciąg o stałej szerokości i z domyślnym ogranicznikiem kartę.
Prototyp (C/C++)
HRESULT GetRangeString(
SQLDMO_LPBSTR pRetVal,
long Top = 0,
long Left = 0,
long Bottom = -1,
long Right = -1,
SQLDMO_LPCSTR RowDelim = NULL,
SQLDMO_LPCSTR ColDelim = NULL,
SQLDMO_LPCSTR ColWidths = NULL);
Ostrzeżenie
SQL-DMO ciągi są zawsze zwracane jako obiekty OLE BSTR.Aplikacja c i C++ pobiera odwołanie do ciąg.Aplikacja musi zwolnić, przy użyciu odwołania SysFreeString.
Zwraca
Ciąg.
Uwagi
Jeśli nie określono żadnych argumentów opcjonalnych, GetRangeString Metoda zwraca ciąg znaków reprezentujący całego zestaw wyników.Pierwszy wiersz tekstu zwracany zestaw wyników zawiera kolumna nazwy.Drugi wiersz zawiera ciągi znaków łącznika, podkreślając kolumna nazwy.
Aby uzyskać więcej informacji na temat parametrów wielociągu ustawienie Zobacz Multistrings za pomocą obiektu SQL-DMO.