/Down/21209.html
adodb.stream對象的方法/屬性
Cancel 方法
使用方法如下
Object.Cancel
說明：取消執行掛起的異步 Execute 或 Open 方法的調用。
Close 方法
使用方法如下
Object.Close
：關閉對像
CopyTo 方法
使用方法如下
Object.CopyTo(destStream,[CharNumber])
說明：將對像的數據復制，destStream指向要復制的對像，CharNumber為可選參數，指要復制的字節數，不選為全部復制。
Flush 方法
使用方法如下
Object.Flush
說明：
LoadFromFile 方法
使用方法如下
Object.LoadFromFile(FileName)
說明:將FileName指定的文檔裝入對像中,參數FileName為指定的用戶名。
Open 方法
使用方法如下
Object.Open(Source,[Mode],[Options],[UserName],[Password])
說明：打開對像，
參數說明：Sourece 對像源，可不指定
Mode 指定打開模式，可不指定，可選參數如下：
adModeRead =1
adModeReadWrite =3
adModeRecursive =4194304
adModeShareDenyNone =16
adModeShareDenyRead =4
adModeShareDenyWrite =8
adModeShareExclusive =12
adModeUnknown =0
adModeWrite =2
Options 指定打開的選項，可不指定，可選參數如下：
adOpenStreamAsync =1
adOpenStreamFromRecord =4
adOpenStreamUnspecified=-1
UserName 指定用戶名，可不指定。
Password 指定用戶名的密碼
Read 方法
使用方法如下：
Object.Read(Numbytes)
說明：讀取指定長度的二進制內容。
參數說明：Numbytes指定的要讀取的找度，不指定則讀取全部。
ReadText 方法
使用方法如下：
Object.ReadText(NumChars)
說明：讀取指定長度的文本
參數說明：NumChars指定的要讀取的找度，不指定則讀取全部。
SaveToFile 方法
使用方法如下：
Object.SaveToFile(FileName,[Options])
說明：將對像的內容寫到FileName指定的文檔中
參數說明：FileName指定的文檔
Options 存取的選項，可不指定，可選參數如下：
adSaveCreateNotExist =1
adSaveCreateOverWrite =2
SetEOS 方法
使用方法如下：
Object.setEOS()
說明：
SkipLine 方法
使用方法如下：
Object.SkipLine()
說明：
Write 方法
使用方法如下：
Object.Write(Buffer)
說明：將指定的數據裝入對像中。
參數說明：Buffer 為指定的要寫入的內容。
WriteText 方法
使用方法如下：
Object.Write(Data,[Options])
說明：將指定的文本數據裝入對像中。
參數說明：Data 為指定的要寫入的內容。
Options 寫入的選項，可不指定，可選參數如下：
adWriteChar =0
adWriteLine =1
有下列屬性：
Charset
EOS 返回對像內數據是否為空。
LineSeparator 指定換行格式，可選參數有
adCR =13
adCRLF =-1
adLF =10
Mode 指定或返加模式。
Position 指定或返加對像內數據的當前指針。
Size 返回對像內數據的大小。
State 返加對像狀態是否打開。
Type 指定或返回的數據類型，可選參數為：
adTypeBinary =1
adTypeText =2
ADO中的record對象:
State 屬性
對所有適用的對象，指示該對象狀態是打開的還是關閉的。
指示對所有可應用的對象執行異步方法，指示對象的當前狀態是正在連接、正在執行還是正在檢索。
返回值
返回可能是 ObjectStateEnum 值的 Long 值。默認值為 adStateClosed。
說明
可以隨時用 State 屬性確定給定對象的當前狀態。
對象的 State 屬性可以是值的組合。例如，如果正在執行某個語句，此屬性將有壹個 adStateOpen 和 adStateExecuting 的組合值。
State 屬性為只讀。
Record 對象
表示 Recordset 中的行，或者文件系統中的文件或目錄。
說明
通過 Record 對象上的 Fields 集合，可以查看與 Record 對象相關聯的字段。ADO 允許值為對象的列，包括 Recordset、SafeArray 和 Record 對象的 Fields 集合中的標量值。
如果 Record 對象表示 Recordset 中的行，那麽它有可能返回原先的 Recordset。
Record 對象可以模仿樹狀結構的名稱空間。樹上的每壹個節點都是壹個具有相關列的 Record 對象。這些列可以表示該節點的屬性和其他相關信息。在該樹狀結構中，Record 對象既可以表示葉節點也可表示非葉節點。非葉節點可將其他節點作為內容，而葉節點沒有這樣的內容。通常，葉節點包含數據的二進制流，而非葉節點也可能有與其相關聯的默認二進制流。Record 對象的屬性標識節點的類型。
Record 對象還表示用於定位分級結構數據的替換方法。可以創建壹個 Record 對象來表示大的樹狀結構中特定子樹的根。可以打開新的 Record 對象，用它們表示子節點。
文件或目錄（即“資源”）由絕對 URL 唯壹標識。當用絕對 URL 打開 Record 時，將顯式地創建 Connection 對象並將其設置為 Record 對象。通過 ActiveConnection 屬性可以將 Connection 對象顯式設置為 Record 對象。可通過 Connection 對象訪問的文件和目錄定義可在其中發生 Record 操作的“上下文”。
Record 對象上的數據修改和定位方法還接受相對 URL，它使用絕對 URL 或 Connection 對象上下文為起點定位資源。
Connection 對象與每壹個 Record 對象相關聯。因此，通過調用 Connection 對象事務方法，可將 Record 對象操作看作事務的壹部分。
Record 對象不支持 ADO 事件，因此不響應通知。
用 Record 對象的方法和屬性可以執行下列操作：
用 ActiveConnection 屬性設置或返回相關聯的 Connection 對象。
用 Mode 屬性指示訪問權限。
用 ParentURL 屬性返回目錄的 URL（如果有），該目錄中包含 Record 表示的資源。
用 Source 屬性指示絕對 URL、相對 URL 或可從中導出 Record 的 Recordset。
用 State 屬性指示 Record 的當前狀態。
用 RecordType 屬性指示 Record 類型——簡單文檔、集合文檔或結構化文檔。
用 Cancel 方法終止執行異步操作。
用 Close 方法斷開 Record 與數據源的關聯。
用 CopyRecord 方法將 Record 表示的文件或目錄復制到另壹位置。
用 DeleteRecord 方法刪除 Record 表示的文件或目錄（及其子目錄）。
用 GetChildren 方法打開包含行的 Recordset，這些行表示項目的子目錄和文件，項目由 Record 表示。
用 MoveRecord 方法將由 Record 表示的文件或目錄（及其子目錄）移動到另壹位置，或者將其重命名。
用 Open 方法將 Record 與現有的數據源相關聯，或者創建壹個新文件或目錄。
Mode 屬性
指示在 Connection、Record 或 Stream 對象中修改數據的有效權限。
設置和返回值
設置或返回 ConnectModeEnum 值。對於 Connection，默認值為 adModeUnknown。對於 Record 對象，默認值為 adModeRead。對於與基本源相關聯的 Stream（用 URL 將其作為源打開或者作為 Record 的默認 Stream 打開），默認值為 adReadOnly。對於與基本源不關聯的 Stream（在內存中實例化），默認值為 adModeUnknown。
說明
使用 Mode 屬性設置或返回當前連接上提供者使用的訪問權限。只有當 Connection 對象關閉時，才能設置 Mode 屬性。
對於 Stream 對象，如果未指定訪問模式，它將從用於打開 Stream 對象的源繼承。例如，如果 Stream 是從 Record 對象打開的，默認情況下它將以打開 Record 對象相同的模式打開。
此屬性在對象關閉時為讀/寫，在對象打開時為只讀。
遠程數據服務用法 當在客戶端的 Connection 對象上使用時，Mode 屬性只能設置為 adModeUnknown。
ParentURL 屬性
指示指向當前 Record 對象的父 Record 的絕對 URL 字符串。
返回值
返回 String 值，指示父 Record 的 URL。
說明
ParentURL 屬性依賴於用於打開 Record 對象的源。例如，可以用包含 ActiveConnection 屬性所引用的目錄的相關路徑名的源打開 Record。
假設“second”是包含在“first”中的文件夾。用下列代碼打開 Record 對象：
record.ActiveConnection = " Publishing）支持。
Source 屬性 (ADO Record)
指示由 Record 對象表示的項目。
設置和返回值
設置或返回 Variant 值，指示由 Record 表示的項目。
說明
Source 屬性返回 Record 對象 Open 方法的 Source 參數。它可包含絕對或相對 URL 字符串。可用絕對 URL 直接打開 Record 對象而無須設置 ActiveConnection 屬性。在這種情況下，將創建隱式的 Connection 對象。
Source 屬性也可以包含對已打開的 Recordset 的引用，該 Recordset 打開表示 Recordset 中的當前行的 Record 對象。
如果還設置了 ActiveConnection 屬性，則 Source 屬性必須指向存在於該連接範圍內的某個對象。例如，在樹狀結構的名稱空間中，如果 Source 屬性包含絕對 URL，它必須指向節點範圍內的節點，該節點範圍由連接字符串中的 URL 標識。如果 Source 屬性包含相對 URL，則它在由 ActiveConnection 屬性設置的上下文中有效。
Source 屬性在 Record 對象關閉時為讀/寫，在 Record 對象打開時為只讀。
State 屬性
對所有適用的對象，指示該對象狀態是打開的還是關閉的。
指示對所有可應用的對象執行異步方法，指示對象的當前狀態是正在連接、正在執行還是正在檢索。
返回值
返回可能是 ObjectStateEnum 值的 Long 值。默認值為 adStateClosed。
說明
可以隨時用 State 屬性確定給定對象的當前狀態。
對象的 State 屬性可以是值的組合。例如，如果正在執行某個語句，此屬性將有壹個 adStateOpen 和 adStateExecuting 的組合值。
State 屬性為只讀。
RecordType 屬性
指示 Record 對象的類型。
返回值
返回 RecordTypeEnum 值。
說明
RecordType 屬性為只讀。
Cancel 方法
取消執行掛起的異步方法調用。
語法
object.Cancel
說明
使用 Cancel 方法終止執行異步方法調用（即用 adAsyncConnect、adAsyncExecute 或 adAsyncFetch 選項調用的方法）。
下表顯示使用特定類型對象的 Cancel 方法時將終止的任務。
如果 object 是 終止對此方法的上壹次異步調用
Command Execute
Connection Execute 或 Open
Record CopyRecord、DeleteRecord、MoveRecord 或 Open
Recordset Open
Stream Open
Close 方法
關閉打開的對象和任何相關的對象。
語法
object.Close
說明
使用 Close 方法關閉 Connection、Record、Recordset 或 Stream 對象以便釋放任何相關聯的系統資源。關閉對象不會將其從內存中刪除；隨後可以更改其屬性設置並再次將其打開。要從內存中徹底清除對象，請在關閉對象後將對象變量設置為 Nothing（在 Visual Basic 中）。
Connection
使用 Close 方法關閉 Connection 對象還將關閉與連接相關聯的任何活動 Recordset 對象。與正在關閉的 Connection 對象相關聯的 Command 對象將被持久保留，但不再與 Connection 對象相關聯，即其 ActiveConnection 屬性將被設置為 Nothing。還將從 Command 對象的 Parameters 集合中清除任何提供者定義的參數。
隨後可以調用 Open 方法重新建立與相同數據源或其他數據源的連接。在 Connection 對象關閉後，調用任何需要與數據源打開連接的方法都將產生錯誤。
當連接上的 Recordset 對象打開時，關閉 Connection 對象將回卷所有 Recordset 對象中的掛起更改。在事務進行過程中顯式關閉 Connection 對象（調用 Close 方法）將產生錯誤。如果在事務進行過程中 Connection 對象超出範圍，ADO 將自動回卷事務。
Recordset、Record 和 Stream
使用 Close 方法關閉 Recordset、Record 或 Stream 對象將釋放相關聯的數據和可能通過此特定對象對數據進行的獨立訪問。隨後可以調用 Open 方法重新打開具有相同屬性或修改屬性的對象。
在 Recordset 對象關閉後，調用任何需要活動遊標的方法都將產生錯誤。
如果在立即更新模式下進行編輯，調用 Close 方法將產生錯誤，應先調用 Update 或 CancelUpdate 方法。如果在批更新模式下關閉 Recordset 對象，自上次 UpdateBatch 調用以來所做的更改將全部丟失。
如果使用 Clone 方法創建打開的 Recordset 對象的副本，關閉原 Recordset 或其副本不會影響任何其他副本。
CopyRecord 方法
把文件或目錄（及其內容）復制到另壹個位置。
語法
CopyRecord (Source, Destination, UserName, Password, Options, Async)
參數
Source 可選。String 值，包含指定要復制的文件或目錄的 URL。如果省略 Source 或指定空字符串，將復制此 Record 所表示的文件或目錄。
Destination 可選。String 值，包含指定要復制 Source 的位置的 URL。
UserName 可選。String 值，包含授權訪問 Destination（如果需要）的用戶 ID。
Password 可選。String 值，包含驗證 UserName（如果需要）的密碼。
Options 可選。CopyRecordOptionsEnum 值，其默認值為 adCopyUnspecified。指定此方法的行為。
Async 可選。Boolean 值，其值為 True 時指定此操作為異步。
返回值
String 值，通常返回 Destination 的值。然而，返回的準確值要取決於提供者。
說明
Source 和 Destination 的值必須相同，否則將發生運行時錯誤。服務器、路徑或資源的名稱至少有壹個不同。
除非指定 adCopyNonRecursive，否則將遞歸復制 Source 的所有子目錄。在遞歸操作中，Destination 不能是 Source 的子目錄，否則操作將不能完成。
如果 Destination 標識現有文件或目錄，除非指定 adCopyOverWrite，否則此方法將失敗。
重要信息 請斟酌使用 adMoveOverWrite 選項。例如，將壹個文件復制到某個目錄時，指定此選項將“刪除”這個目錄，並用此文件替換它。
DeleteRecord 方法
刪除文件或目錄（包括目錄中的所有子目錄）。
語法
DeleteRecord Source, Async
參數
Source 可選。String 值，包含標識要刪除的文件或目錄的 URL。如果省略 Source 或指定空字符串，此 Record 表示的文件或目錄將被刪除。
Async 可選。Boolean 值，其值為 True 時將指定刪除操作為異步。
說明
此方法完成後，對由 Record 表示的文件或目錄執行的操作可能失敗。在調用 DeleteRecord 後，根據 Provider 用數據源更新 Record 的時間不同，Record 的行為可能不可預料，因此應將 Record 關閉。
如果此 Record 從 Recordset 獲取，那麽在 Recordset 中將不會立即反映此操作的結果。關閉並重新打開 Recordset，或者執行 Recordset Requery 或 Update 和 Resync 方法，將刷新 Recordset。
GetChildren 方法
返回 Recordset，其中的行表示由此 Record 表示的目錄中的文件和子目錄。
語法
Set recordset = record.GetChildren
返回值
Recordset 對象，其中的每壹行表示壹個文件或目錄。
說明
提供者確定在返回的 Recordset 中包含哪些列。例如，文檔源提供者始終返回資源 Recordset。
MoveRecord 方法
把文件或目錄（及其內容）移到另壹個位置。
語法
MoveRecord (Source, Destination, UserName, Password, Options, Async)
參數
Source 可選。String 值，包含標識要移動的 Record 的 URL。如果省略 Source 或指定空字符串，將移動此 Record 表示的文件或目錄。
Destination 可選。String 值，包含指定要移動的 Source 的位置的 URL。
UserName 可選。String 值，包含授權訪問 Destination（如果需要）的用戶 ID。
Password 可選。String，包含驗證 UserName（如果需要）的密碼。
Options 可選。MoveRecordOptionsEnum 值，其默認值為 adMoveUnspecified。指定此方法的行為。
Async 可選。Boolean 值，其值為 True 時將指定此操作為異步。
返回值
String 值。通常返回 Destination 值。然而，返回的準確值要取決於提供者。
說明
Source 和 Destination 的值必須相同，否則將發生運行時錯誤。至少服務器、路徑和資源的名稱不能相同。
此方法將更新正被移動的文件中的所有超文本鏈接（除 Options 指定的以外）。如果 Destination 標識現有的文件或目錄，除非指定 adMoveOverWrite，否則此方法將失敗。
註意 請斟酌使用 adMoveOverWrite 選項。例如，把壹個文件移動到某個目錄中，指定此選項將刪除這個目錄並用此文件替換它。
此操作完成後，Record 對象的某些屬性（如 ParentURL 屬性）將不會被更新。關閉 Record 然後用文件或目錄移動位置的 URL 重新打開它，即可刷新 Record 對象的屬性。
如果此 Record 是從 Recordset 獲取的，移動的文件或目錄的新位置將不會立即反映在 Recordset 中。關閉並重新打開將刷新 Recordset。