Open Method (ADO Stream)

Статья
01/19/2017

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

Синтаксис

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

Параметры

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

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

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

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

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

Замечания

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

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

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

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

Применимо к

объект Stream (ADO)

См. также

Open Method (ADO Connection)
Open Method (ADO Record)
Open Method (ADO Recordset)
метода OpenSchema
метод SaveToFile

Поделиться через