Метод Open (объект Stream ADO)

  • Статья

Открывает объект Stream для управления потоками двоичных или текстовых данных.

Синтаксис

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

Параметры

Источник
Необязательный элемент. Значение Variant , указывающее источник данных для Stream. Источник может содержать абсолютную строку URL-адреса, указывающую на существующий узел в известной древовидной структуре, такой как электронная почта или файловая система. URL-адрес должен быть указан с помощью ключевое слово URL-адреса ("URL=scheme://server/folder"). Кроме того, source может содержать ссылку на уже открытый объект Record , который открывает поток по умолчанию, связанный с записью. Если источник не указан, создается и открывается экземпляр Stream , который по умолчанию не связан с базовым источником. Дополнительные сведения о схемах URL-адресов и связанных с ними поставщиках см. в разделе Абсолютные и относительные URL-адреса.

Режим
Необязательный элемент. Значение ConnectModeEnum , указывающее режим доступа для результирующей потоковой передачи (например, для чтения и записи или только для чтения). Значение по умолчанию — adModeUnknown. Дополнительные сведения о режимах доступа см. в свойстве Mode . Если параметр Mode не указан, он наследуется исходным объектом. Например, если исходная запись открыта в режиме только для чтения, stream также будет открываться в режиме только для чтения по умолчанию.

OpenOptions
Необязательный элемент. Значение StreamOpenOptionsEnum . Значение по умолчанию — adOpenStreamUnspecified.

UserName
Необязательный элемент. Строковое значение, содержащее идентификатор пользователя, который при необходимости получает доступ к объекту Stream.

Пароль
Необязательный элемент. Строковое значение, содержащее пароль, который при необходимости получает доступ к объекту Stream.

Комментарии

Когда объект Record передается в качестве исходного параметра, параметры UserID и Password не используются, так как доступ к объекту Record уже доступен. Аналогичным образом режим объекта Record передается в объект Stream . Если источник не указан, открытый поток не содержит данных и имеет нулевой размер (0). Чтобы избежать потери данных, записываемых в этот поток при закрытии Stream , сохраните Stream с помощью методов CopyTo или SaveToFile или сохраните их в другом расположении памяти.

Значение OpenOptionsadOpenStreamFromRecord определяет содержимое параметра Source как уже открытый объект Record . По умолчанию источник рассматривается как URL-адрес, указывающий непосредственно на узел в древовидной структуре, например файл. Открывается поток по умолчанию, связанный с этим узлом.

Пока stream не открыт, можно считывать все свойства Stream, доступные только для чтения. Если stream открывается асинхронно, все последующие операции (кроме проверки состояния и других свойств только для чтения) блокируются до завершения операции Open .

Помимо параметров, которые обсуждались ранее, не указывая источник, можно создать экземпляр объекта Stream в памяти, не связывая его с базовым источником. Вы можете динамически добавлять данные в поток, записывая двоичные или текстовые данные в Stream с помощью write или WriteText или загружая данные из файла с помощью LoadFromFile.

Применение

Объект Stream (ADO)

См. также:

Метод Open (объект Connection ADO)
Метод Open (объект Record ADO)
Метод Open (объект Recordset ADO)
Метод OpenSchema
Метод SaveToFile