Os objetos FileSystemObject são usados para acessar o sistema de arquivos no servidor. Este objeto pode manipular caminhos de arquivos, pastas e diretórios. Também é possível usá-lo para recuperar informações do sistema de arquivos.
O código a seguir cria um arquivo de texto e escreve algum texto:
<%
dim fs,fnome
definir fs=Server.CreateObject("Scripting.FileSystemObject")
definir fname=fs.CreateTextFile("c:/test.txt",true)
fname.WriteLine("Olá mundo!")
fname.Fechar
definir fname = nada
definir fs = nada
%>
As propriedades e métodos do objeto FileSystemObject são os seguintes:
1. Atributos
Drives: Retorna um conjunto de todos os objetos Drive no computador.
gramática:
[drivecoll=]FileSystemObject.Drives
2. Método
Bulidpath: Adicione um nome a um caminho existente.
CopyFile: Copie um ou mais arquivos de um lugar para outro.
CopyFolder: Copie uma ou mais pastas de um lugar para outro.
CreateFolder: Crie uma nova pasta.
CreateTextFile: Cria um arquivo de texto e retorna um objeto TextStream para leitura e gravação do arquivo de texto criado.
DeleteFile: Exclua um ou mais arquivos especificados.
DeleteFolder: Exclua uma ou mais pastas especificadas.
DriveExists: verifica se a unidade especificada existe.
FileExists: verifica se o arquivo especificado existe.
FolderExists: verifica se a pasta especificada existe.
GetAbsolutePathName: Retorna o caminho completo do caminho especificado.
GetBaseName: Retorna o nome base do arquivo ou pasta especificado.
GetDrive: Retorna o objeto Drive correspondente na unidade no caminho especificado.
GetDriveName: Retorna o nome da unidade do caminho especificado.
GetExtensionName: Retorna a extensão do arquivo da última parte do caminho especificado.
GetFile: Retorna um objeto de arquivo para o caminho especificado.
GetFileName: Retorna a última parte do nome do arquivo ou nome da pasta no caminho especificado.
GetFolder: Retorna um objeto de pasta no caminho especificado.
GetParentFolderName: Retorna a última parte do nome da pasta pai no caminho especificado.
GetSpecialFolder: Retorna o caminho para uma pasta especial no Windows.
GetTempName: Retorna um arquivo ou pasta temporário gerado aleatoriamente.
MoveFile: Mova um ou mais arquivos de um lugar para outro.
MoveFolder: Mova um ou mais arquivos de um lugar para outro.
OpenTextFile: Abre um arquivo e retorna um objeto TextStream para leitura e gravação do arquivo aberto.
Método BuildPath
O método BuildPath adiciona um nome a um caminho existente.
1. Gramática
[newpath=]FileSystemObject.BuildPath(caminho,nome)
Descrição do parâmetro:
caminho: obrigatório. caminho.
nome: O nome a ser adicionado.
2. Exemplos
<%
dim fs, caminho
definir fs=Server.CreateObject("Scripting.FileSystemObject")
caminho=fs.BuildPath("c:/meusdocumentos","teste")
resposta.write(caminho)
definir fs = nada
%>
Saída:
c:/meusdocumentos/teste
Método CopyFile
O método CopyFile copia um ou mais arquivos de um lugar para outro.
1. Gramática
FileSystemObject.CopyFile origem,destino[,sobrescrever]
Descrição do parâmetro:
fonte: obrigatório. O arquivo a ser copiado.
destino: obrigatório. O destino para onde copiar.
substituir: opcional. É um valor booliano que indica se os arquivos existentes devem ser substituídos. Verdadeiro significa cobertura, Falso significa nenhuma cobertura. O padrão é Verdadeiro.
2. Exemplos
<%
dimfs
definir fs=Server.CreateObject("Scripting.FileSystemObject")
fs.CopyFile "c:/meusdocumentos/web/*.htm","c:/webpages/"
definir fs = nada
%>
Método CopyFolder
O método CopyFolder copia um ou mais arquivos de um lugar para outro.
1. Gramática
FileSystemObject.CopyFolder origem, destino [, substituir]
Descrição do parâmetro:
fonte: obrigatório. A pasta a ser copiada.
destino: obrigatório. O destino para onde copiar.
substituir: opcional. É um valor booliano que indica se os arquivos existentes devem ser substituídos. Verdadeiro significa cobertura, Falso significa nenhuma cobertura. O padrão é Verdadeiro.
2. Exemplos
<%
'copie todas as pastas em c:/mydocuments/web
'para a pasta c:/webpages
dimfs
definir fs=Server.CreateObject("Scripting.FileSystemObject")
fs.CopyFolder "c:/meusdocumentos/web/*","c:/webpages/"
definir fs = nada
%>
<%
'copia apenas a pasta test de c:/mydocuments/web
'para a pasta c:/webpages
dimfs
definir fs=Server.CreateObject("Scripting.FileSystemObject")
fs.CopyFolder "c:/meusdocumentos/web/teste","c:/webpages/"
definir fs = nada
%>
Método CreateFolder
O método CreateFolder cria uma nova pasta.
1. Gramática
FileSystemObject.CreateFolder(nome)
Descrição do parâmetro:
nome: obrigatório. O nome da pasta a ser criada.
2. Exemplos
<%
escuro fs,f
definir fs=Server.CreateObject("Scripting.FileSystemObject")
definir f=fs.CreateFolder("c:/asp")
definir f = nada
definir fs = nada
%>
Método CreateTextFile
O método CreateTextFile cria um novo arquivo de texto na pasta atual e retorna um objeto TextStream para leitura e gravação desse novo arquivo.
1. Gramática
FileSystemObject.CreateTextFile(nome do arquivo[,substituir[,unicode]])
FolderObject.CreateTextFile(nome do arquivo[,substituir[,unicode]])
Descrição do parâmetro:
nome do arquivo: obrigatório. O nome do arquivo a ser criado.
substituir: opcional. É um valor booliano que indica se um arquivo existente deve ser substituído. Verdadeiro significa cobertura, Falso significa nenhuma cobertura. O padrão é Verdadeiro.
Unicode: opcional. Um valor booliano que indica se o arquivo que está sendo criado é um arquivo Unicode ou ASCII. True é um arquivo Unicode, False é um arquivo ASCII. O padrão é Falso.
2. Exemplos
Exemplo de FileSystemObject:
<%
dim fs,tfile
definir fs=Server.CreateObject("Scripting.FileSystemObject")
definir tfile=fs.CreateTextFile("c:/somefile.txt")
tfile.WriteLine("Olá mundo!")
tfile.fechar
settfile = nada
definir fs = nada
%>
Exemplo de objeto Pasta:
<%
dim fs,fo,tfile
Definir fs=Server.CreateObject("Scripting.FileSystemObject")
Definir fo=fs.GetFolder("c:/teste")
Definir tfile=fo.CreateTextFile("test.txt",falso)
tfile.WriteLine("Olá mundo!")
tfile.Fechar
settfile = nada
definir fo = nada
definir fs = nada
%>
Método DeleteFile
O método DeleteFile exclui um ou mais arquivos especificados.
NOTA: Ocorrerá um erro se você tentar excluir um arquivo que não existe.
1. Gramática
FileSystemObject.DeleteFile(nomedoarquivo[,forçar])
Descrição do parâmetro:
nome do arquivo: obrigatório. O nome do arquivo a ser excluído.
força: opcional. Um valor booliano que indica se os arquivos somente leitura devem ser excluídos. Verdadeiro significa sim, Falso significa não. O padrão é Falso.
2. Exemplos
<%
dimfs
Definir fs=Server.CreateObject("Scripting.FileSystemObject")
fs.CreateTextFile("c:/test.txt",Verdadeiro)
se fs.FileExists("c:/test.txt") então
fs.DeleteFile("c:/teste.txt")
terminar se
definir fs = nada
%>
Método DeleteFolder
Método DeleteFolder O método DeleteFile exclui uma ou mais pastas especificadas.
NOTA: Ocorrerá um erro se você tentar excluir uma pasta que não existe.
1. Gramática
FileSystemObject.DeleteFolder(nomedapasta[,forçar])
Descrição do parâmetro:
nome da pasta: obrigatório. O nome do arquivo a ser excluído.
força: opcional. Um valor booliano que indica se as pastas somente leitura devem ser excluídas. Verdadeiro significa sim, Falso significa não. O padrão é Falso.
2. Exemplos
<%
dimfs
definir fs=Server.CreateObject("Scripting.FileSystemObject")
se fs.FolderExists("c:/temp") então
fs.DeleteFolder("c:/temp")
terminar se
definir fs = nada
%>
Método DriveExists
O método DriveExists retorna um valor booliano que indica se a unidade especificada existe. Verdadeiro significa existência, Falso significa não.
1. Gramática
FileSystemObject.DriveExists(unidade)
Descrição do parâmetro:
dirigir: obrigatório. Uma letra de unidade ou uma descrição completa do caminho.
2. Exemplos
<%
dimfs
definir fs=Server.CreateObject("Scripting.FileSystemObject")
se fs.DriveExists("c:")=true então
response.write("A unidade c: existe!")
outro
response.write("A unidade c: não existe.")
fimSe
definir fs = nada
%>
Método FileExists
O método FileExists retorna um valor booleano que indica se o arquivo especificado existe. Verdadeiro significa existência, Falso significa não.
1. Gramática
FileSystemObject.FileExists (nome do arquivo)
Descrição do parâmetro:
nome do arquivo: obrigatório. O nome do arquivo a ser verificado.
2. Exemplos
<%
dimfs
definir fs=Server.CreateObject("Scripting.FileSystemObject")
se fs.FileExists("c:/asp/introduction.asp")=true então
response.write("Arquivo c:/asp/introduction.asp existe!")
outro
response.write("Arquivo c:/asp/introduction.asp não existe!")
terminar se
definir fs = nada
%>
Método FolderExists
O método FolderExists retorna um valor booleano que indica se a pasta especificada existe. Verdadeiro significa existência, Falso significa não.
1. Gramática
FileSystemObject.FolderExists(nome da pasta)
Descrição do parâmetro:
nome da pasta: obrigatório. O nome da pasta a ser verificada.
2. Exemplos
<%
dimfs
definir fs=Server.CreateObject("Scripting.FileSystemObject")
se fs.FolderExists("c:/asp")=true então
response.write("A pasta c:/asp existe!")
outro
response.write("A pasta c:/asp não existe!")
terminar se
definir fs = nada
%>
Método GetAbsolutePathName
O método GetAbsolutePathName retorna o caminho completo para o caminho especificado (converte o caminho especificado em um caminho absoluto).
1. Gramática
FileSystemObject.GetAbsolutePathName(caminho)
Descrição do parâmetro:
caminho: obrigatório. O caminho a ser convertido em um caminho absoluto.
2. Exemplos
Suponha que o diretório atual seja c:/temp/test:
Exemplo 1
<%
dim fs, caminho
definir fs=Server.CreateObject("Scripting.FileSystemObject")
caminho=fs.GetAbsolutePathName("c:")
resposta.write(caminho)
%>
Saída:
c:/temp/teste
Exemplo 2
<%
dim fs, caminho
definir fs=Server.CreateObject("Scripting.FileSystemObject")
caminho=fs.GetAbsolutePathName("meudoc.txt")
resposta.write(caminho)
%>
Saída:
c:/temp/test/mydoc.txt
Exemplo 3
<%
dim fs, caminho
definir fs=Server.CreateObject("Scripting.FileSystemObject")
caminho=fs.GetAbsolutePathName("privado/meudoc.txt")
resposta.write(caminho)
%>
Saída:
c:/temp/test/private/mydoc.txt
Método GetBaseNome
O método GetBaseName retorna o nome base do arquivo ou pasta no caminho especificado.
1. Gramática
FileSystemObject.GetBaseName(caminho)
Descrição do parâmetro:
caminho: obrigatório. O caminho para o arquivo ou pasta.
2. Exemplos
<%
dimfs
definir fs=Server.CreateObject("Scripting.FileSystemObject")
Response.Write(fs.GetBaseName("c:/winnt/cursors/3dgarro.cur"))
definir fs = nada
%>
Saída:
3dgarro
Método GetDrive
O método GetDrive retorna um objeto Drive especificado pelo parâmetro drivespec.
1. Gramática
FileSystemObject.GetDrive(drivespec)
Descrição do parâmetro:
drivespec: obrigatório. Pode ser uma letra de unidade © ou uma letra de unidade seguida por dois pontos (c:) ou uma letra de unidade seguida por dois pontos e um separador de caminho (c:/) ou uma descrição de compartilhamento de rede (//computer2/share1 ).
2. Exemplos
<%
dim fs,d
definir fs=Server.CreateObject("Scripting.FileSystemObject")
definir d=fs.GetDrive("c:/")
definir fs = nada
%>
Método GetDriveName
O método GetDriveName retorna uma string contendo o nome da unidade no caminho especificado.
1. Gramática
FileSystemObject.GetDriveName(caminho)
Descrição do parâmetro:
caminho: obrigatório. O caminho especificado.
2. Exemplos
<%
dim fs,nome
definir fs=Server.CreateObject("Scripting.FileSystemObject")
dname=fs.GetDriveName("c:/test/test.htm")
Resposta.Write(nome_do_nome)
definir fs = nada
%>
Saída:
c:
Método GetExtensionName
O método GetExtensionName retorna uma string contendo a extensão da última parte do arquivo no caminho especificado.
1. Gramática
FileSystemObject.GetExtensionName(caminho)
Descrição do parâmetro:
caminho: obrigatório. O caminho especificado.
2. Exemplos
<%
dimfs
definir fs=Server.CreateObject("Scripting.FileSystemObject")
Response.Write(fs.GetExtensionName("c:/test/test.htm"))
definir fs = nada
%>
Saída:
htm
Método GetFile
O método GetFile retorna um objeto File para o caminho especificado.
1. Gramática
FileSystemObject.GetFile (caminho)
Descrição do parâmetro:
caminho: obrigatório. Sobre o caminho para um arquivo específico.
2. Exemplos
<%
escuro fs,f
definir fs=Server.CreateObject("Scripting.FileSystemObject")
definir f=fs.GetFile("c:/test/test.htm")
Response.Write("O arquivo foi modificado pela última vez em: ")
Response.Write(f.DateLastModified)
definir f = nada
definir fs = nada
%>
Saída:
O arquivo foi modificado pela última vez em 01/01/20 04:23:56
Método GetFileName
O método GetFileName retorna uma string contendo a última parte do nome do arquivo ou pasta no caminho especificado.
1. Gramática
FileSystemObject.GetFileName(caminho)
Descrição do parâmetro:
caminho: obrigatório. Sobre o caminho para um arquivo ou pasta específico.
2. Exemplos
<%
escurecer fs,p
definir fs=Server.CreateObject("Scripting.FileSystemObject")
p=fs.getfilename("c:/teste/teste.htm")
resposta.write(p)
definir fs = nada
%>
Saída:
teste.htm
<%
escurecer fs,p
definir fs=Server.CreateObject("Scripting.FileSystemObject")
p=fs.getfilename("c:/teste/")
resposta.write(p)
definir fs = nada
%>
Saída:
teste
Método GetFolder
O método GetFolder retorna um objeto Folder para o caminho especificado.
1. Gramática
FileSystemObject.GetFolder(caminho)
Descrição do parâmetro:
caminho: obrigatório. O caminho para uma pasta específica.
2. Exemplos
<%
escuro fs,f
definir fs=Server.CreateObject("Scripting.FileSystemObject")
definir f=fs.GetFolder("c:/teste/")
Response.Write("A pasta foi modificada pela última vez em: ")
Response.Write(f.DateLastModified)
definir f = nada
definir fs = nada
%>
Saída:
A pasta foi modificada pela última vez em 01/01/20 04:23:56
Método GetParentFolderName
O método GetParentFolderName retorna o nome da última parte da pasta pai no caminho especificado.
1. Gramática
FileSystemObject.GetParentFolderName(caminho)
Descrição do parâmetro:
caminho: obrigatório. O caminho do arquivo ou pasta cujo nome da pasta pai deve ser retornado.
2. Exemplos
<%
escurecer fs,p
definir fs=Server.CreateObject("Scripting.FileSystemObject")
p=fs.GetParentFolderName("c:/winnt/cursors/3dgarro.cur")
Resposta.Write(p)
definir fs = nada
%>
Saída:
c:/winnt/cursores
Método GetSpecialFolder
O método GetSpecialFolder retorna o caminho para uma pasta específica do Windows.
1. Gramática
FileSystemObject.GetSpecialFolder (nome da pasta)
Descrição do parâmetro:
nome da pasta: obrigatório.
descrição do valor do nome da pasta:
0=WindowsFolder (contém arquivos instalados pelo sistema operacional Windows);
1=SystemFolder (contém bibliotecas, fontes e drivers de dispositivo)
2=TemporaryFolder (usado para armazenar arquivos temporários)
2. Exemplos
<%
escurecer fs,p
definir fs=Server.CreateObject("Scripting.FileSystemObject")
definir p=fs.GetSpecialFolder(1)
Resposta.Write(p)
definir p = nada
definir fs = nada
%>
Saída:
C:/WINNT/system32
Método GetTempName
O método GetTempName retorna um arquivo ou pasta temporário gerado aleatoriamente.
1. Gramática
FileSystemObject.GetTempName
2. Exemplos
<%
dim fs,tfolder,tname,tfile
Definir fs=Server.CreateObject("Scripting.FileSystemObject")
Definir tfolder=fs.GetSpecialFolder(2)
tname=fs.GetTempName
Definir tfile=tfolder.CreateTextFile(tname)
Resposta.write(tfile)
%>
Saída:
trb2007.tmp
Método MoveFile
O método MoveFile move um ou mais arquivos de um lugar para outro.
1. Gramática
FileSystemObject.MoveFile origem, destino
Descrição do parâmetro:
fonte: obrigatório. O caminho para o arquivo a ser movido.
destino: obrigatório. O local para onde se mudar.
2. Exemplos
<%
dimfs
definir fs=Server.CreateObject("Scripting.FileSystemObject")
fs.MoveFile "c:/web/*.gif","c:/images/"
definir fs = nada
%>
Método MoveFolder
O método MoveFolder move uma ou mais pastas de um lugar para outro.
1. Gramática
FileSystemObject.MoveFolder origem, destino
Descrição do parâmetro:
fonte: obrigatório. O caminho da pasta a ser movida.
destino: obrigatório. O local para onde se mudar.
2. Exemplos
<%
dimfs
definir fs=Server.CreateObject("Scripting.FileSystemObject")
fs.MoveFolder "c:/teste/web/","c:/windows/"
definir fs = nada
%>
Método OpenTextFile
O método OpenTextFile abre um arquivo especificado e retorna um objeto TextStream para acessar o arquivo.
1. Gramática
FileSystemObject.OpenTextFile(fname,modo,criar,formatar)
Descrição do parâmetro:
nome: obrigatório. O nome do arquivo a ser aberto.
modo: opcional. Como abri-lo. 1=ForReading (aberto apenas para leitura), 2=ForWriting (aberto para escrita), 8=ForAppending (aberto para anexar, o conteúdo escrito será adicionado ao final do arquivo).
criar: opcional. Define se o arquivo aberto deve ser criado se ele não existir. Verdadeiro significa sim, Falso significa não. O padrão é Falso.
formato: opcional. O formato do arquivo. 0=TristateFalse (abrir no formato ASCII, que é o padrão), -1=TristateTrue (abrir no formato Unicode), -2=TristateUseDefault (abrir no modo padrão do sistema)
2. Exemplos
<%
escuro fs,f
definir fs=Server.CreateObject("Scripting.FileSystemObject")
definir f=fs.OpenTextFile(Server.MapPath("testread.txt"),8,true)
f.WriteLine("Este texto será adicionado ao final do arquivo")
f.Fechar
definir f=Nada
definir fs=Nada
%>
Propriedade
Descrição da propriedade
descrever
Atributos
Define ou retorna os atributos de um arquivo especificado
Define ou retorna as propriedades do arquivo especificado
Data de criação
Retorna a data e hora em que um arquivo especificado foi criado
Retorna a data e hora em que o arquivo especificado foi criado
Data do último acesso
Retorna a data e hora em que um arquivo especificado foi acessado pela última vez
Retorna a data e hora em que o arquivo especificado foi acessado pela última vez
Data da última modificação
Retorna a data e hora em que um arquivo especificado foi modificado pela última vez
Retorna a data e hora em que o arquivo especificado foi modificado pela última vez
Dirigir
Retorna a letra da unidade onde reside um arquivo ou pasta especificado
Retorna a letra da unidade onde o arquivo ou pasta especificado está localizado
Nome
Define ou retorna o nome de um arquivo especificado
Define ou retorna o nome do arquivo especificado
Pasta Pai
Retorna o objeto pasta do pai do arquivo especificado
Retorna a pasta pai do arquivo especificado
Caminho
Retorna o caminho de um arquivo especificado
Retorna o caminho para um arquivo especificado
Nome curto
Retorna o nome abreviado de um arquivo especificado (a convenção de nomenclatura 8.3)
Retorna o nome abreviado de um arquivo especificado (de acordo com as regras de nomenclatura 8.3)
Caminho curto
Retorna o caminho curto de um arquivo especificado (a convenção de nomenclatura 8.3)
Retorna o caminho curto de um arquivo especificado (de acordo com as regras de nomenclatura 8.3)
Tamanho
Retorna o tamanho, em bytes, de um arquivo especificado
Retorna o número de bytes contidos no arquivo especificado
Tipo
Retorna o tipo de um arquivo especificado
Retorna o tipo do arquivo especificado
Métodos
método
Método
Descrição do método
descrever
Cópia
Copia um arquivo especificado de um local para outro
Copie arquivos da máquina local para uma máquina remota
ExcluirExclui um arquivo especificado
Excluir arquivo especificado
Mover
Move um arquivo especificado de um local para outro
Mover arquivos da máquina local para uma máquina remota
OpenAsTextStream
Abre um arquivo especificado e retorna um objeto TextStream para acessar o arquivo
Abra o arquivo especificado e retorne um objeto TextStream
Este artigo é apresentado aqui. Recomenda-se continuar lendo os artigos relevantes abaixo para saber mais.