Metodo Open (Stream - ADO)

Apre un oggetto Stream per modificare i flussi di dati binari o di testo.

Sintassi

  
Stream.Open Source, Mode , OpenOptions, UserName, Password  

Parametri

Origine
facoltativo. Valore Variant che specifica l'origine dei dati per il Flusso. L'Origine può contenere una stringa URL assoluta che punta a un nodo esistente in una struttura ad albero ben nota, ad esempio un indirizzo di posta elettronica o un file system. Un URL deve essere specificato usando la parola chiave URL ("URL=schema://cartella/server"). In alternativa, l'Origine può contenere un riferimento a un oggetto Record già aperto, che apre il flusso predefinito associato al Record. Se l'Origine non è specificata, viene creata un'istanza di un Flusso che viene aperta, non associata a un'origine sottostante per impostazione predefinita. Per altre informazioni sugli schemi URL e sui relativi provider associati, vedere URL relativi e assoluti.

Modalità
facoltativo. Valore ConnectModeEnum che specifica la modalità di accesso per il Flusso risultante, ad esempio lettura/scrittura o sola lettura. Il valore predefinito è adModeUnknown. Per altre informazioni sulle modalità di accesso, vedere la proprietà Mode. Se la proprietà Mode non è specificata, viene ereditata dall'oggetto di origine. Ad esempio, se il Record di origine viene aperto in modalità di sola lettura, anche il Flusso verrà aperto in modalità di sola lettura per impostazione predefinita.

OpenOptions
facoltativo. Valore StreamOpenOptionsEnum. Il valore predefinito è adOpenRecordUnspecified.

UserName
facoltativo. Valore String che contiene l'identificazione dell'utente che, se necessario, accede all'oggetto Stream.

Password
facoltativo. Valore String che contiene la password che, se necessario, accede all'oggetto Stream.

Osservazioni

Quando un oggetto Record viene passato come parametro di origine, i parametri UserID e Password non vengono usati perché l'accesso all'oggetto Record è già disponibile. Analogamente, la Modalità dell'oggetto Record viene trasferita all'oggetto Stream. Quando l'Origine non è specificata, il Flusso aperto non contiene dati e ha una Dimensione pari a zero (0). Per evitare di perdere tutti i dati scritti in questo Flusso quando il Flusso viene chiuso, salvare il Flusso con i metodi CopyTo o SaveToFile o salvarli in un altro percorso di memoria.

Un valore OpenOptions di adOpenStreamFromRecord identifica il contenuto del parametro Source come oggetto Record già aperto. Il comportamento predefinito consiste nel considerare Source come un URL che punta direttamente a un nodo in una struttura ad albero, come un file. Il flusso predefinito associato a tale nodo viene aperto.

Anche se il Flusso non è aperto, è possibile leggere tutte le proprietà di sola lettura del Flusso. Se un Flusso viene aperto in modo asincrono, tutte le operazioni successive (diversamente dal controllo dello Stato e altre proprietà di sola lettura) vengono bloccate fino al completamento dell'operazione Open.

Oltre alle opzioni descritte in precedenza, non specificando Source, è possibile creare un'istanza di un oggetto Stream in memoria senza associarla a un'origine sottostante. È possibile aggiungere dati dinamicamente al flusso scrivendo dati binari o di testo nel Flusso con Write o WriteText o caricando i dati da un file con LoadFromFile.

Si applica a

Oggetto Stream (ADO)

Vedere anche

Metodo Open (Connection - ADO)
Metodo Open (Record - ADO)
Metodo Open (Recordset - ADO)
Metodo OpenSchema
Metodo SaveToFile