Метод Open (Stream в ADO)
Область применения: Access 2013, Office 2013
Открывает объект Stream для управления потоками двоичных или текстовых данных.
Синтаксис
Stream. Open Source, Mode, OpenOptions, UserName, Password
Параметры
| Параметр | Описание |
|---|---|
| Source | Необязательный параметр. Значение Variant, указывающее источник данных для Stream. Источник может содержать абсолютную строку URL-адреса, указывающую на существующий узел в хорошо известной древовидной структуре, например электронной почты или файловой системе. URL-адрес должен быть указан с помощью URL-ключевое слово ("URL=scheme://server/folder"). Кроме того, источник может содержать ссылку на уже открытый объект Record , который открывает поток по умолчанию, связанный с записью. Если источник не указан, создается и открывается экземпляр Stream, связанный без базового источника по умолчанию. Дополнительные сведения о схемах URL-адресов и связанных с ними поставщиках см. в разделе Абсолютные и относительные URL-адреса. |
| Mode | Необязательный параметр. Значение ConnectModeEnum, указывающее режим доступа для результирующей Stream (например, для чтения, записи или только для чтения). Значение по умолчанию — adModeUnknown. Дополнительные сведения о режимах доступа см. в свойстве Mode . Если параметр Mode не указан, он наследуется исходным объектом. Например, если исходная запись открыта в режиме только для чтения, Stream также будет открываться в режиме только для чтения по умолчанию. |
| OpenOptions | Необязательный параметр. Значение StreamOpenOptionsEnum . Значение по умолчанию — adOpenStreamUnspecified. |
| UserName | Необязательный параметр. Строковое значение, содержащее идентификатор пользователя, который при необходимости обращается к объекту Stream. |
| Password | Необязательный параметр. Строковое значение, содержащее пароль, который при необходимости обращается к объекту Stream. |
Замечания
При передаче объекта Record в качестве параметра источника параметры UserID и Password не используются, так как доступ к объекту Record уже доступен. Аналогичным образом режим объекта Record передается в объект Stream. Если источник не указан, открытый Stream не содержит данных и имеет нулевой размер (0). Чтобы избежать потери данных, записанных в этот Stream при закрытии Stream, сохраните Stream с помощью методов CopyTo или SaveToFile или сохраните его в другом расположении памяти.
Значение OpenOptionsобъекта adOpenStreamFromRecord определяет содержимое параметра Source как уже открытый объект Record . Поведение по умолчанию — рассматривать источник как URL-адрес, указывающий непосредственно на узел в древовидной структуре, например файл. Открывается поток по умолчанию, связанный с этим узлом.
Хотя Stream не открыт, можно считывать все доступные только для чтения свойства Stream. Если Stream открывается асинхронно, все последующие операции (кроме проверки состояния и других доступных только для чтения свойств) блокируются до завершения операции Open.
Помимо описанных выше параметров, не указывая источник, можно просто создать экземпляр объекта Stream в памяти, не связывая его с базовым источником. Вы можете динамически добавлять данные в поток, просто записывая двоичные или текстовые данные в Stream с помощью write или WriteText или загружая данные из файла с помощью LoadFromFile.